PDF Properties
Using a custom set of XML tags inside your HTML, you can insert both custom metadata as well as instructions for how the PDF would be viewed in a PDF viewer application (subject of course to that application supporting those features).
Options
You use the (optional) tag <pdfproperties> and within that tag you
can insert <metainfo> and <pdfpreferences>
sections as shown in the instructions below. Within the
<metainfo> tag, you can add <prop> tags
with @name, @value attribute pairs with the data you wish
to store in the PDF metadata. Anything without one of the recognized, standard PDF
names (author, title, subject,
creator, keywords) are stored in custom metadata in
the PDF.
The <pdfpreferences> section allows you to insert one or more
<pref> tags with specific @name,
@value pairs that control the way the resulting PDF is displayed
with a viewer that supports standard PDF view attributes. The support
name, @value pairs are listed below and grouped into
all the available categories:
General PDF Options
These options let you control some general information about the generated PDF.
bookmarks - sets whether PDF bookmarks are generated or not. The default
is "false" for Cloudformatter. You can set @value to "true" if you want
bookmarks in PDF. Note that bookmarks are only generated for interpreted
hierarchical information. All h1 elements and there following
h2 elements and so on. Skipping levels will break the sequence and
the bookmarks will not be correct.
pdf-version - sets the PDF version number. The default is version 1.5
for Cloudformatter but you set @value to values like "1.3", "1.4",
"1.6" or "1.7" if you wish to change the version. Be aware thar some other features
could be disabled by setting the version too low.
compress - sets whether the PDF is compressed or not. The default is
"true" for Cloudformatter. You can set @value to "false" if you want
uncompressed PDF.
linearize - sets whether the PDF is linearized or not. The default is
"false" for Cloudformatter. You can set @value to "true" if you want to
optimize a long PDF for web view.
PDF View Options
These options let you control how the PDF when opened appears to the end user.
view-mode - Choose from one of the following:
auto- If there are bookmarks in the document, the bookmarks pane is displayed. Otherwise, all auxiliary panes are hidden.show-none- All auxiliary panes are hidden.show-bookmarks- The bookmarks pane is displayed.show-thumbnails- The thumbnails pane is displayed.full-screen- The document is displayed in full screen-mode.
initial-zoom - Choose from one of the following:
auto- Page scaling is not specified.fit- The page is scaled to fit completely into the view port.fit-width- The page is scaled so that its width matches the width of the view port.fit-height- The page is scaled so that its height matches the height of the view port.###or####%- The page is scaled by the number or percentage specified.
page-layout - Choose from one of the following:
auto- Uses settings of viewer application.single-page- Displays one page at a time.continuous- Displays pages continuously in one column.two-columns-left- Displays pages continuously in two columns, with odd-numbered pages to the left.two-columns-right- Displays pages continuously in two columns, with odd-numbered pages to the right.two-pages-left- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the left.two-pages-right- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the right.
viewer-preferences - A comma separated list of the following
possibilities:
hide-toolbar- Hides the viewer application's tool bars when the document is active.hide-menubar- Hides the viewer application's menu bar when the document is active.hide-window-ui- Hides user interface elements in the document's window (such as scroll bars and navigation controls), leaving only the document's contents displayed.fit-window- Resizes the document's window to fit the size of the first displayed page.center-window- Positions the document's window in the center of the screen.display-document-title- Controls whether the window's title bar displays the document title taken from the "title" metadata field.
PDF Security
These options allow you to specify owner and user security in the PDF output. User-level security can inject a password to be used to open the PDF, while owner-level security can control what can be done with the PDF (like printing it or copying the data from it).
userpassword - Sets the user password that must be entered to view the
PDF. There are no options, the @value passed is the password to be
used.
ownerpassword - Sets the owner password that must be entered to enable
advanced processing of the PDF. There are no options, the @value passed
is the password to be used. An ownerpassword is used to lock down certain privledges
that an owner will grant to a recipient of the PDF. Without the owner password,
recipients can be restricted from certain things. By default they are restricted
from everything, and you can then specify what additional things you allow by using
userpriviledges.
userpriviledges - A comma separated list of the following
possibilities:
print- Enables printing the document.modify- Enables editing the document.copy- Enables copying text and images from the document to the clipboard.annotate- Enables adding notations to the document and changing the field values.
PDF Pre-Press Options
These allow you to specify crop marks, bleeds and registration marks to be applied to the PDF.
crop-offset - specify offsets from the meaningful content on the page to
the edges of the physical media (/MediaBox entry in the PDF page dictionary). Its
value is a series of 1 to 4 length specifiers that set offsets from the edges of the
page area to the corresponding edges of the /MediaBox. Rules for expanding the value
are the same as for the padding property in CSS.
bleed - specify the bleeds — an extra space around the page area into
which the contents of the page may protrude (/BleedBox entry in the PDF page
dictionary). Its value is a series of 1 to 4 length specifiers that set offsets from
the edges of the page area to the corresponding edges of the /BleedBox. Rules for
expanding the value are the same as for the padding property in CSS.
crop-mark-width - defines line width for the crop marks, setting it to 0
disables drawing of crop marks.
bleed-mark-width - defines line width for the bleed marks, setting it to
0 disables drawing of bleed marks.
printer-mark - specify additional SVG images to be drawn in the offset
area surrounding the page (specified by crop-offset and bleed parameters). Printer
marks are clipped to the outside of the bleed rectangle. The @value is
a URL to an SVG you have. This sample has two URLs (one for a colorbar and one for a
registration mark) you can also use if you like.
The following code is what is behind this page for producing the PDF. Of course, you would only see the things supported by your PDF viewer you use. If you wish to see them all in action, then use "download" and Adobe Reader to view the PDF.
Recent changes in some browsers will not treat this XML as XML. Instead it tries (incorrectly) to not close tags. For best results, be sure to use open and close tags and not a self-closing tag.
<pdfproperties style="display:none;">
<metainfo>
<prop name="author" value="Xportability LLC"></prop>
<prop name="title"
value="Xportability Cloudformatter: Showing Custom
PDF Properties"></prop>
<prop name="subject" value="A Cloudformatter Document"></prop>
<prop name="creator" value="css2pdf@cloudformatter.com"></prop>
<prop name="keywords" value="CSS, PDF, Cloudformatter"></prop>
<prop name="custom1" value="value1"></prop>
<prop name="custom2" value="value2"></prop>
<prop name="custom3" value="value3"></prop>
<prop name="custom4" value="value4"></prop>
</metainfo>
<pdfpreferences>
<pref name="bookmarks" value="true"></pref>
<pref name="pdf-version" value="1.6"></pref>
<pref name="view-mode" value="auto"></pref>
<pref name="initial-zoom" value="fit-height"></pref>
<pref name="page-layout" value="two-columns-left"></pref>
<pref name="viewer-preferences" value="display-document-title"></pref>
<pref name="crop-offset" value="0.5in"></pref>
<pref name="crop-mark-width" value="1px"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/registration.svg"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/colorbar.svg"></pref>
</pdfpreferences>
</pdfproperties>
Sample Output H2
At duis erat suscipit diam. Stet diam dolore eros justo euismod nonumy est est ut gubergren takimata nisl sea aliquyam commodo exerci eos. Facer facilisis facer stet tempor sed diam minim aliquyam invidunt. Nonumy et facilisis. Nulla facilisis voluptua labore kasd placerat praesent et et et duo ea duo doming gubergren. Eos sanctus sed aliquip eum placerat ea consetetur ut eros dolores sea vulputate gubergren amet in aliquyam. Autem laoreet et sanctus stet diam eos dolor euismod nobis justo vulputate voluptua.
Sadipscing eos et sed accusam vel diam kasd dolore congue ut vero suscipit tempor sanctus. Kasd eirmod sea amet takimata nobis amet sadipscing eirmod. Vel et adipiscing vero erat dolor labore magna. Tempor duo amet no sea sanctus kasd vel augue diam illum duo ipsum qui eos. Tempor sit dolores sit tation sed laoreet ipsum at sed vero.
Sample Output H3
Et erat sed labore dolore dignissim et dolore et lorem exerci clita sea dolore ea laoreet magna. Ea facilisi et voluptua labore et in blandit no sed dolor labore ea et ea diam clita. Eum lorem molestie ea et et takimata sit sed vel soluta sit. Amet vero consetetur eros sed accumsan sadipscing ut no elitr elitr. Adipiscing enim amet et rebum aliquyam lorem lorem odio aliquyam. Sadipscing eleifend no ex et luptatum sed sea et dolor amet aliquyam sed lobortis sanctus at augue duo sadipscing.
Dolor diam consectetuer et nulla invidunt kasd lorem rebum elitr lorem tempor nibh dignissim diam dolore elitr vero. Ea labore diam eirmod amet adipiscing est nulla. Lorem at invidunt quis rebum sea autem dolor lobortis magna sea. Aliquyam lorem invidunt accusam dolor at doming eirmod. Sadipscing est duis sadipscing magna diam dolores. Sanctus consequat euismod clita eos et accumsan accusam voluptua sanctus molestie accusam stet sadipscing sed et lorem eos magna. Erat dolor sanctus diam ut in commodo.
Sample Output H4
Lorem eirmod duo dolor elitr dolores nonumy dolore diam in est iriure rebum et molestie. Et et et consetetur eum nonumy. Gubergren elitr voluptua sea veniam dolor lorem nonummy vel. Lorem est mazim qui at possim facilisis. Labore adipiscing sed sed. Ipsum at dolor dignissim possim voluptua enim te facilisis ea facilisi elitr est et sea autem ut feugiat.
At luptatum dolores aliquyam lorem sed amet nibh consetetur duis dolor consetetur aliquam diam sit et sit sea. Justo nonumy voluptua vulputate nonumy amet duis lorem eos praesent lorem lorem lorem molestie sanctus nonumy diam. Nonumy consequat congue lorem eirmod esse duo kasd stet et diam accusam voluptua dolore hendrerit eu voluptua. Amet ipsum diam stet eros. Labore sea diam stet illum et rebum velit. Tation vero iriure odio in sit nulla. Sed eirmod esse nibh ipsum mazim dolores euismod hendrerit kasd et et. Aliquyam no vero elitr diam aliquyam vel iusto doming ullamcorper sed nonumy. Labore sed sit takimata odio eu sed erat amet et ipsum aliquyam invidunt ut. Eirmod sed rebum nonumy ut magna dolore lorem odio nibh clita eirmod ea sit dolor option erat in vel. Nonumy diam sit lorem tincidunt clita esse magna ut accusam stet sed nostrud accusam adipiscing cum hendrerit.
Sample Output H4
At ipsum augue consetetur stet sed consetetur clita. Magna eros iriure. Et sadipscing labore sed sed sea aliquyam justo. Lorem sit sit magna et quod exerci dolor. Takimata sed et et nonumy diam ut iusto. Gubergren lorem nisl lorem in duis eirmod in et eirmod at clita molestie no. Dolore laoreet et elitr kasd takimata sit aliquam invidunt et justo dolor gubergren. Eirmod sea sadipscing molestie amet rebum vero. Amet sanctus ipsum dolor dolore vero takimata nonumy est dolor dolore dolor gubergren luptatum consetetur sadipscing at nonumy et.
Et et sed sanctus velit. Dolor lorem et esse amet no diam voluptua iriure labore dolore vero. Clita sit clita sit stet facilisis eos. Vel et erat at minim vero duo duo et amet ex consetetur tation sea vulputate. Ipsum clita sadipscing dolore feugiat sed lorem justo rebum. Diam nonumy est iriure takimata ut labore voluptua. Dolore clita rebum ea ut voluptua et stet voluptua et feugiat dolor ut. Sit iriure dolor labore sed diam amet amet minim kasd diam nisl clita aliquyam nam. Minim sadipscing molestie diam takimata duo dolore accusam sea sanctus ullamcorper lorem diam.
Sample Output H3
Consequat ut praesent eirmod ipsum est sit sadipscing. Duo iusto amet ipsum tempor sit dolor vero takimata ullamcorper vero tempor vel. Consequat lorem duo aliquyam. Illum aliquyam erat gubergren nulla sit no. Dolor sed ipsum labore aliquyam amet dolor duis invidunt sit dolore labore kasd no iriure dolor in. Kasd dolor id ut velit duo vero elitr diam consetetur lobortis eos accusam.
Elitr ipsum lorem et eos. Eirmod sit stet dolor dolore kasd sit autem laoreet id sit. Sanctus sit sea at dolor ea. Sed eirmod dolor no sea feugiat dolor nonummy eos sit sanctus gubergren vero dolores ipsum accumsan velit dolore iusto. Ipsum sed sed amet. Lorem iriure ipsum et ut autem nulla amet tempor dolor ut.
Sample Output H4
Voluptua ea vel qui vero amet labore labore facilisis eu sea. Accusam sit tempor te magna lorem. Lorem nostrud lorem invidunt dolore diam volutpat nonumy dolor accumsan. Magna sanctus consetetur gubergren no sanctus et ut ipsum labore. Labore eum dolores no commodo. Tempor facer sed sanctus elit voluptua at dolores dolor. Dolore aliquyam at sanctus sanctus consetetur.
Dolor ad kasd velit. Ut commodo amet. Tempor at voluptua justo eos sed et invidunt takimata eu amet tempor dolor ipsum. Ut sed wisi labore. Consetetur dolore nonumy hendrerit elitr rebum dolore.
Sample Output H4
Feugait vulputate takimata sit erat eirmod. At gubergren delenit labore. Justo option exerci dignissim et consetetur ipsum duo gubergren ipsum. Voluptua et dolor at ut. Imperdiet sed gubergren kasd tempor kasd no sadipscing labore. Rebum dolor et duo et sit eirmod voluptua magna sit eos invidunt et nisl. Nonumy iusto dolore feugiat lorem at vel takimata.
Justo erat ipsum dolore gubergren dolore veniam eirmod nisl et et sadipscing. Et voluptua dolor diam id et dolore. Sit accumsan tation ipsum id minim autem augue at dolore erat tincidunt. Sit accusam accumsan consetetur eu rebum sed ipsum iriure. Lobortis sit invidunt zzril facer ut consectetuer tempor labore. Et takimata iusto diam ut iusto praesent dolores. Erat sit et vulputate ea dolore nonumy sanctus et kasd sea et rebum illum sanctus. Sit facilisi ea est eos. Amet consetetur diam dolore. Et et no voluptua magna.
More Sample Output H2
Praesent wisi dolor nonummy et. Sit sit cum voluptua diam commodo in elitr praesent. Et amet sit kasd invidunt invidunt sanctus id vel ex labore et et vero invidunt iriure assum sed. Sanctus dolor mazim consectetuer dolores lorem odio sea justo labore vero est dolore dolore hendrerit voluptua eros eu dolor. Vel diam et aliquyam sed nonumy erat dolor erat diam ea rebum accusam invidunt sit consetetur gubergren consequat ipsum. Et clita esse gubergren eos dolor sit nam sit magna sadipscing et invidunt est. Sed ipsum exerci nonumy eirmod at no diam sed ex. Nisl magna et elit molestie sanctus diam clita tempor ut nonumy ea at eum diam sed amet amet.
Diam et dignissim luptatum et autem est ea ut eos vel doming takimata stet. Possim ut ipsum sit dolore diam at volutpat labore in diam invidunt consectetuer nonummy dolor sea voluptua. Est et vulputate quis ut sit consectetuer vero nibh. Stet amet minim no stet vulputate nonumy eos ipsum est. Gubergren ipsum volutpat invidunt amet adipiscing imperdiet vulputate eirmod rebum. In ea accusam. Erat erat nihil ut erat takimata feugiat eu cum et sed eu vero sed assum aliquyam.
Sample Output H3
Sit kasd erat et magna amet rebum diam aliquip takimata aliquip lorem et imperdiet ut et duo gubergren. Dolores no vero zzril eum stet ipsum kasd ea. Zzril et dolores takimata dolore et sed duo praesent vero dolor et. Vero odio sed tempor ut amet kasd sed eos vero odio elitr sit velit dolore dignissim sea invidunt. Ipsum adipiscing dolor facilisi dolore et ipsum ut aliquyam lorem invidunt liber dolor amet dolor ipsum erat. Diam kasd ea ipsum dolore in dolore no dolores at dolor. Erat feugait lorem eos vero nonumy.
Stet amet nonumy et zzril elitr odio et aliquyam sit hendrerit eirmod dolor sed autem tation ipsum sed nisl. Et lorem nulla duis takimata option ipsum nibh duo justo et eirmod ea ea dolor consectetuer voluptua elitr diam. Accusam ea sit accusam nobis et. Takimata sit diam no nulla invidunt exerci magna gubergren eirmod amet. Amet sanctus aliquyam est nibh eum sadipscing et tempor nonumy et eirmod. Diam nibh diam lorem justo dolore clita sanctus ipsum dolore dolore sed tation hendrerit dolor eirmod labore elitr. Gubergren tincidunt diam dolores sed autem hendrerit duis elitr clita amet duo erat.
Sample Output H4
Kasd elitr volutpat et diam illum eirmod sed. Consetetur dolore stet et amet sit amet dolor sit lorem feugiat stet consequat vero amet illum delenit at. Justo elitr clita ex commodo eirmod. Et ipsum justo dolore no iriure labore in mazim sea sit et kasd sit et elitr. Ut aliquyam sadipscing stet commodo magna sit diam at elit sea nonumy magna sit magna dolore ex et. Amet facilisis sit dolore erat. Et elitr ipsum rebum stet at augue. Elitr sadipscing odio nulla dolor.
Dolor voluptua labore et at laoreet te sed possim. Elitr odio vel sadipscing quis clita dolore aliquyam consetetur sed eu dolor dolor. Est consetetur diam suscipit at. Dolores invidunt duo diam erat lorem kasd luptatum lorem. At ut sed vero iusto lorem dolore takimata dolore rebum vero sit vero dolor et justo. Eos kasd dolore et sit dolores amet lorem nonumy tempor voluptua elit sanctus amet. Diam stet adipiscing erat vero eos diam ut augue et elitr.
Sample Output H4
Sit stet esse est clita elitr nonumy lorem accusam lorem ut dolores et et dolore. No vel eros vel sea sea clita augue diam amet eirmod dolore no dolor dolore. In tation dolore autem ea sit wisi rebum dolore vero est stet sea kasd et lorem elitr dolores. Nonumy et dolore consetetur kasd. Diam sed dolor aliquam sanctus dolor lorem amet praesent at iusto ut est dolor. At duis accusam ut ipsum lorem lorem et dignissim. Et elitr option sadipscing sadipscing sit amet at consetetur voluptua diam et gubergren dignissim diam vel. Sea ut ipsum ut invidunt dolore amet rebum eirmod. Gubergren no ipsum ut kasd. Et dolore est.
Accumsan erat in nonummy sanctus tempor eirmod tincidunt et dolor takimata. Esse kasd aliquyam blandit eleifend nonumy consetetur diam nulla. Takimata diam et at diam clita duo eirmod et. Vel voluptua labore takimata adipiscing elitr. Accusam takimata est duo aliquam justo at dolores ipsum ad.
Sample Output H3
Elitr kasd wisi hendrerit lorem. Eleifend exerci invidunt velit voluptua nostrud. Imperdiet justo est gubergren illum vero eirmod no ea tempor illum sadipscing. Dolor odio gubergren no tempor nonummy tempor dolores magna gubergren. Duo ut ea. Commodo takimata ipsum. Sit cum voluptua labore et facilisis. Quod sed illum kasd vero eirmod dolores clita eirmod consetetur ut. Option rebum aliquam ea et sea diam sed eum eirmod takimata gubergren vero labore.
Ipsum tempor invidunt nonumy consequat ea eirmod nonummy tempor aliquam invidunt vulputate amet. Aliquyam tempor ipsum stet justo esse elitr nonumy gubergren amet consetetur molestie consetetur. Eirmod dolore aliquam diam nam et no. Takimata sit exerci labore sadipscing amet kasd veniam et clita elitr nonumy sea justo diam amet iriure ea. Rebum et quis delenit dolores odio dolor accusam labore dolor sit justo magna dolore duo erat ipsum. Sanctus elitr rebum sea magna et vero sadipscing et kasd dolor diam clita sit elitr rebum. Facilisis et minim autem elit at eirmod sed dolore diam.
Sample Output H4
Vero diam vulputate euismod at et sanctus elitr odio dolor assum in takimata dolor vulputate eirmod sadipscing. Lorem gubergren dolores sanctus diam vel est accumsan in dolores sed. Vel delenit sanctus et sit ut veniam sit tempor facer esse eos. Exerci diam at. Consectetuer justo amet qui dolor nulla at consetetur. Sit sadipscing sea labore aliquyam. Ea nonumy esse eos esse quod minim ut id ipsum sit. Consetetur sadipscing consequat sit justo sit et kasd ipsum nostrud stet invidunt eirmod. Sanctus ex tempor erat accusam dolor te diam. Labore vero ipsum accumsan amet dolores labore diam dolore sit amet dolor sit invidunt magna vero erat stet justo. Et takimata ut invidunt dolor in ea lorem diam sea ipsum dolores dolores ut duis.
Sanctus voluptua consetetur. Ea gubergren sed nonumy consectetuer lorem ea magna consetetur vero exerci facilisi praesent praesent quod facer duo accusam laoreet. Duo rebum amet minim kasd duis luptatum molestie. Sea takimata velit tation aliquyam sanctus lorem clita autem dolor duo amet erat consequat. Diam gubergren duis aliquip sanctus dolore ipsum molestie. Tincidunt sit et ea consetetur sanctus tempor et clita delenit invidunt invidunt eos dolore dolore dolore. Erat ipsum et at molestie ea adipiscing duis vulputate. Lorem et minim nisl consetetur at amet invidunt duo labore labore duo elitr ea clita iusto. Ipsum dolor dolores erat.
Sample Output H4
Dolore sit ad augue consetetur invidunt. Feugait dolore ex. Eirmod nonumy diam kasd elitr ad sanctus sit soluta. At kasd kasd est ad magna. Et nulla eos consetetur accusam nulla ut ea aliquyam vero est et elitr. Erat et sadipscing diam lobortis at elitr ullamcorper dolor clita et id sed aliquip. Ipsum accumsan amet sanctus at facilisis takimata eum eos. Eum duis et clita sit et diam te ut ad dolore dolores diam sanctus sanctus tincidunt. Sit kasd clita amet ea congue eos nostrud lorem. Consetetur et dolores tincidunt molestie justo kasd diam nihil adipiscing consetetur eleifend eros justo et vel elitr magna. Sit eum lorem est aliquyam erat labore clita est magna dolor eos duo autem no in.
Nonumy no dolor et sed sed elitr invidunt amet. Dolore clita est takimata et nulla takimata nulla amet sed tempor amet ex nibh sanctus nulla duis sea voluptua. Dolore aliquyam sanctus no ipsum eos. Nulla enim est clita augue amet ipsum amet minim sea nostrud magna diam eros wisi consetetur. Nihil consetetur vero in. Dolores quis cum takimata sed accumsan nulla liber amet est ut sed gubergren et diam et iriure. Odio ut stet ipsum diam vero ut voluptua clita. Eos erat elitr duo feugiat liber ipsum voluptua nonummy diam. Elitr nonumy sanctus et nonumy dolor illum et soluta accusam adipiscing. Labore blandit rebum nulla rebum ut at invidunt sit sed at sed ipsum clita ut nostrud est duo.