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
Est luptatum nonummy sea voluptua. Stet et in. Nonummy sadipscing lorem et rebum dolore amet luptatum duo clita praesent ipsum et. Labore est takimata diam aliquyam stet esse nibh. Kasd sea quis vel tempor consequat diam amet lorem diam elitr accusam. Sit dolore lorem autem elitr stet ipsum doming eirmod dolor eum no justo duo sadipscing. Feugait erat nostrud est no eirmod vero invidunt sed exerci dolor feugiat iriure erat voluptua sed nihil.
Ut dolores labore odio feugait diam eirmod vero takimata dolore vel duo kasd sit justo aliquyam. Rebum et aliquyam rebum. Suscipit aliquip ea consetetur assum ea sea voluptua ea et. Rebum dignissim delenit dolore sea lorem dolor. Duis dolores diam. In invidunt illum exerci dolore sed rebum nulla volutpat diam delenit clita lorem ipsum veniam nonumy. Duis magna ipsum aliquyam magna sit sea nonumy ut vulputate kasd at no dolore diam dolores rebum stet. Sea eirmod at autem. Elit sit et sanctus sit gubergren est takimata. Dolor et tempor diam labore voluptua aliquip et vero. Et lorem invidunt sit sed est iriure ut diam iusto dolore invidunt eos et id vulputate aliquyam et.
Sample Output H3
Rebum ut aliquam volutpat duis ut accusam sed sed. Justo tempor ea. Amet amet sadipscing nonumy labore wisi takimata. Ea adipiscing esse kasd elitr dolor enim rebum amet. Ipsum aliquip sit amet dolores esse enim consetetur et ea et dolor dolores amet accusam consetetur accusam feugait magna. Facilisi odio feugiat tation suscipit tempor ipsum praesent et vel feugiat amet elitr. Eirmod aliquyam blandit feugait wisi est sanctus feugait ex et duo sit dolor in vulputate. Dolore et et esse sanctus sit eos tation. Erat lorem et dignissim ipsum et at gubergren vero takimata at nibh dolor voluptua facilisis ut. Dolores sadipscing vero consetetur dignissim sanctus diam sanctus duo voluptua labore et eirmod exerci eos erat minim.
Diam lorem diam sit sed dolores consetetur consequat rebum elitr suscipit dolor et lorem nonumy sed rebum duo. Eum dolor eirmod. Sed erat diam facilisi ea stet. Eos illum liber diam amet sanctus duis elitr. No tation ipsum stet. Dolore et vero duo adipiscing gubergren. Consetetur placerat amet consectetuer ut elitr te et justo at no sed kasd. Consequat eos dolore no kasd.
Sample Output H4
Invidunt clita et et voluptua. Ipsum stet dolore. Qui dolor nonumy tempor diam te consetetur dolor tempor. Et commodo dolore et clita sit accusam iriure no erat nonummy esse illum dolore nonummy sed stet amet no. Nihil no tempor eos at amet ea at quod feugiat eirmod veniam et veniam sit tempor aliquyam et. Vero diam magna diam dolor clita sit dolore sea no minim ipsum stet lorem sadipscing eos kasd sea. Ut consectetuer tempor enim ipsum sit sed stet rebum justo et velit delenit aliquyam nonumy labore dolores diam.
Clita clita rebum sea zzril sed labore vero amet luptatum elitr diam dolor. Takimata lorem eirmod elit duo elitr kasd. Dolore quis takimata eirmod et justo labore et voluptua sit nonumy elitr ipsum ipsum invidunt sed. At erat dolores consequat. At aliquyam consetetur elitr et at duis suscipit vero option tation clita. Et illum kasd kasd et sed elitr in erat ut. Ullamcorper gubergren praesent no feugiat consetetur stet.
Sample Output H4
Ut autem diam sadipscing vero dolore elitr placerat velit. Magna lorem ea duo vel consetetur. Dolor rebum voluptua consetetur at ipsum amet sea sit gubergren. Lorem eos duo lorem nostrud et amet accumsan hendrerit duo invidunt dolores praesent wisi. Kasd et eos at sadipscing. Zzril voluptua sit ipsum ex tempor no lorem et dolore in eirmod ea est feugiat justo tempor.
Lobortis sea dignissim in sea aliquyam vero et at tempor rebum erat voluptua dolores sea tempor ipsum et. Gubergren erat dignissim vulputate in invidunt rebum delenit commodo veniam. Te gubergren facer voluptua lobortis sea erat nam qui ipsum voluptua autem dolores kasd dolor ipsum veniam est. Duo et dolor praesent feugiat diam. Duo consetetur dolor sit. At sit est sit est takimata ipsum magna magna.
Sample Output H3
Ea sit et ut ipsum sed nonumy labore elit consetetur no consequat invidunt ad te. Dolore eleifend no ea nonumy eos. Sit lorem et illum ipsum delenit at eos voluptua eum in clita dolore vel nisl erat invidunt. Labore dolore sed et praesent justo dolore erat eu facilisi magna iusto sea et amet autem et ipsum vero. Ut assum accumsan clita et lorem duis dolor dolor sed vel et justo no accusam feugait. Ut dolore veniam dolores duo magna tempor. Est ut dignissim praesent justo rebum cum amet kasd dolor veniam exerci accusam et augue sed feugiat.
Stet duis ipsum amet dolor lorem et dolor est nulla. Accumsan nam est consetetur sed duo elitr nisl te rebum sed ut sea. Vero dolor dolor. Tempor stet tempor erat sit. Sed dolores diam qui dolor ea et eirmod rebum adipiscing et no ipsum voluptua diam. Dolore dolor sea sed et sed amet sed iriure. Ut amet duo consetetur sea diam kasd dolore amet minim erat elitr sanctus et magna eros. No clita kasd ipsum enim.
Sample Output H4
Nonumy vero tation est justo amet sed augue eos. Kasd et magna hendrerit gubergren et ipsum et diam voluptua praesent diam takimata nobis kasd delenit est. Lorem rebum lorem. Sed gubergren est sit nihil sanctus stet erat est. Duo clita magna no amet invidunt dolore sed duo diam in et gubergren et. Gubergren consetetur ut consetetur est rebum at. Lorem kasd est labore. Invidunt hendrerit no ut possim dolor.
Stet invidunt ipsum justo tempor et amet facilisis ut et sit eos dolore in amet no ut sit. Nonumy eirmod gubergren dolor in duo sanctus sadipscing et ex rebum justo. Elitr lobortis eos no lorem voluptua duo. Dolore et clita. Eos clita consetetur et ea dolore ipsum possim dolores nobis. Gubergren eirmod stet consectetuer. Vero nonumy eos lorem molestie ullamcorper aliquyam no minim diam est ipsum dolore dolor. Lorem feugait nulla dolores takimata clita kasd gubergren ut iriure autem vero takimata luptatum magna accusam. Sea odio sit consetetur in ea sit stet magna ut adipiscing.
Sample Output H4
Velit nam consetetur kasd ut sit erat eum nibh justo. Aliquyam tempor feugait. Consectetuer est facilisis. Et sed nonumy sit diam sit dolor in euismod eirmod at diam clita dolore at. Elitr autem dolor ea elit. Te facilisis accusam dolores ipsum iusto. Kasd stet diam diam amet sit magna duis amet accusam ea est sadipscing lorem nonummy. Elitr lorem rebum delenit tempor ipsum tempor no diam. Elitr tempor amet vero eirmod ipsum no. Delenit sed ipsum dolore nonummy invidunt gubergren eos feugiat diam nobis amet diam. Duo no erat.
Elitr lorem rebum voluptua duo amet. Magna sadipscing ut et dolore dolores erat diam. Invidunt nisl nostrud no erat est delenit duo nonummy at consequat et et justo dolor. Facilisis rebum labore dolore eleifend et aliquyam. Et aliquyam ut blandit nonumy sit ut wisi consequat diam ea accusam esse justo. Invidunt ipsum sit ut dolore amet sed diam. Accusam dolore velit justo nulla takimata nulla stet laoreet sea diam eu lobortis magna eos dolore sed ut. Magna est zzril.
More Sample Output H2
Iriure magna sanctus dignissim praesent eirmod nobis sed consetetur elitr dolore esse nam et ut vulputate eirmod. Iriure illum lorem eos ipsum feugait eos dolores lorem duis ipsum. Et ut amet dignissim te et delenit tempor sit. Accumsan sit magna lorem dolore ipsum in sed labore sit consectetuer nostrud justo euismod est. Et sit vel kasd labore dolor quod ea labore te est. Aliquyam magna diam. At iriure sanctus tempor et amet ut dolor ut aliquyam lorem dolor clita at consectetuer lorem luptatum voluptua ex. Sed sanctus eirmod aliquam. Elitr voluptua at rebum nisl ut. Et adipiscing adipiscing duis tempor duo ut. Kasd sadipscing accumsan lorem dolore in.
At labore nonumy aliquyam et lorem gubergren eirmod. Justo ut diam eos et tincidunt et consetetur amet eum dolor consetetur diam duo lorem. Ad et ipsum. Duo dolor sit velit gubergren ea. Dolor sanctus euismod. Nonumy erat elitr ex et at dolore ullamcorper lorem liber te ut consetetur diam duis volutpat et. Est et gubergren. Nam lorem dolores nonumy stet nonumy lorem te sit.
Sample Output H3
Suscipit takimata feugiat magna dolore kasd amet accusam sed facilisis amet accumsan sit sit volutpat erat iriure feugiat sanctus. Accusam sea sea accumsan diam consequat consetetur eirmod accusam. Diam justo voluptua diam exerci et dolor. Ut nulla nonumy amet elitr duo sit ipsum. Esse ipsum accusam gubergren consetetur exerci tempor consectetuer. Sit eos nostrud iriure nonumy kasd amet lobortis commodo. Ipsum tincidunt exerci illum et sed sit tempor aliquyam nonumy dolores consetetur. Nonumy dolor hendrerit ut eleifend doming et et duo voluptua kasd eirmod rebum.
Ex diam sit liber labore accusam amet kasd kasd lorem vero justo ipsum ipsum eros kasd amet invidunt. Magna elitr praesent vero erat sea aliquam amet labore ipsum ea. Ipsum ea sanctus amet consectetuer facilisi. No euismod sadipscing in erat aliquyam eros nulla ut voluptua sed ipsum dolores dolor duo accusam. Invidunt et et eum ea eros kasd eum nonumy voluptua accusam lorem sadipscing lorem diam nonumy. Diam justo nibh dolor nonumy eum sed ex dolores. Consetetur sit duis no ea nostrud. Ea ut velit praesent sadipscing ea et amet amet. Dignissim vero elitr eos sit at sit at ipsum. Dolor sit accusam sed dolor option eos duo. Elit luptatum odio no duo nonumy sanctus consequat.
Sample Output H4
Est kasd takimata. Sea et voluptua no ipsum elitr at dolores vel et ut duis justo rebum ipsum accusam stet. Ea eirmod assum takimata labore. Facilisi ut amet. Labore elitr euismod aliquyam sed facilisi stet dignissim. Diam id at dignissim stet dolor sit vero accusam et sed vel augue possim dolor sit takimata dignissim sit. Kasd esse stet magna dolores dolore tincidunt in est sanctus amet dolor sed lorem eos kasd nonumy duis at. Dolore nostrud vel magna lorem vero accusam dolore et labore gubergren et duis ad kasd lorem magna. Lorem magna lorem consetetur justo sit no nonumy. Ea ut magna sanctus erat aliquyam sed sanctus ut luptatum dolore. Sea clita takimata consetetur accusam nonumy diam invidunt dolore assum duo ut.
Gubergren sanctus facilisi diam invidunt sanctus consequat sit vulputate est dolores sed est voluptua odio te voluptua. Amet tempor consetetur et dolor lorem lorem amet cum lorem sed dolor ipsum sit nulla accusam. Invidunt volutpat elit enim feugait voluptua eros possim dolor no sadipscing ut ipsum cum justo clita erat cum vero. Sed sea facilisi vero at ipsum et tation sit accumsan sanctus et labore diam illum consetetur veniam nulla vulputate. Dolor commodo amet sed eos gubergren diam magna sea kasd aliquam te ullamcorper. Consetetur sed gubergren ut ipsum sanctus kasd tempor quod doming dolor dolor dolor tation labore voluptua sed accusam stet. Feugiat exerci clita minim amet consequat consectetuer. Amet delenit sanctus delenit gubergren erat sit sanctus labore no ipsum. Ut ea lorem ea nonumy imperdiet no eu.
Sample Output H4
Blandit ipsum vel sea elitr dolor dolores rebum justo sed elitr nostrud tempor. In takimata elit et dolore. Ut dolore duo dolor dolor dolores iusto diam ut diam at ea nonumy et magna hendrerit et ipsum aliquip. Eirmod est diam eum et voluptua sea gubergren. Consequat clita invidunt sanctus ipsum magna. Sit labore dolore at. Nonumy odio erat dolore vero et ipsum zzril augue diam. Diam dolor diam tempor illum est et accusam sanctus vel.
Sea iusto dolor ex nonumy tempor nulla nobis lorem euismod labore amet dolor consetetur autem elit vero sea erat. Consetetur amet amet elitr rebum sit sed accumsan stet no et dolore diam doming lorem consetetur dolore dolores. Ad duo nonumy sed hendrerit rebum nonumy cum at. Voluptua dolor magna dolor et ea. Nisl invidunt invidunt feugiat. Accusam eirmod diam vero. Sadipscing facilisi facilisi nonumy luptatum nisl zzril et ipsum est nostrud facilisis feugiat vero kasd dolor. Sea clita eirmod. Takimata iriure et molestie zzril veniam ea dignissim aliquyam. Consetetur dolore imperdiet feugiat clita wisi ipsum possim. Dolores invidunt labore erat accusam magna sea amet clita nonumy lorem erat volutpat ut.
Sample Output H3
Clita et ut invidunt sit sit no ipsum blandit ea nulla magna in. Ipsum amet consequat erat et dolor et labore est facer lobortis te. Nulla et iusto iriure dolor at rebum lorem soluta ut lorem erat nobis et dolore tation sanctus ullamcorper diam. Hendrerit odio ut kasd ipsum rebum no ad imperdiet kasd kasd consequat tempor adipiscing. Duis amet eos kasd sanctus no lobortis consectetuer. Et eum accusam sed laoreet et lorem ut feugiat ea amet at dolor. Eum et illum amet et in vero sanctus in et et qui veniam.
Et clita voluptua accusam sea amet tincidunt nulla labore. Eirmod stet voluptua et ea. No te vel lorem sed at stet et consetetur elitr sea lorem clita sit accusam. Et sea veniam vero nonumy lorem facilisis ut justo voluptua amet stet amet dolor magna sed sea illum. Gubergren aliquyam duo praesent clita praesent diam voluptua. Dolores dolore takimata wisi. Iriure sit vulputate eos stet. Lorem ea labore dolore dolor diam amet praesent duo clita tempor quis dolor at. Stet lorem diam delenit. Lorem sed nibh duo rebum amet ut dolor.
Sample Output H4
Dolor consectetuer sit et accumsan amet veniam. Minim et dolores facer tation eirmod minim ea accusam in est eu ipsum vel. Sanctus illum voluptua lorem dolores dolores labore est. Erat lorem dolor aliquam rebum rebum dolores dolores dolores eros no elitr tation tempor invidunt. Amet rebum magna rebum elitr accusam. Magna diam nonumy diam sed.
Sanctus et duo dolor eros vero ut dolor sit. Est eirmod labore eos in dolore. Lorem eos vel ipsum ipsum. Nulla erat no ipsum tempor iriure at eos molestie euismod blandit liber. Eos te eleifend erat invidunt facer rebum. Sed diam ut ullamcorper exerci erat sed invidunt vero clita duo ipsum ea sed duo dolores dolor aliquam aliquam. Ut ipsum magna minim consequat vero. Vero iusto euismod minim sea.
Sample Output H4
Eirmod et nonumy aliquyam vel ipsum labore clita at quis ipsum ut duis. Facilisi eu dolore illum dolores labore eos accumsan. Nonumy vero lorem accusam. Et aliquyam justo euismod stet. Amet consetetur erat eos voluptua no hendrerit et eos.
Labore ea sed option nonumy et diam sed consectetuer est feugait justo lorem sanctus id. Et tempor amet nonumy. Diam sadipscing ut congue. Sanctus feugait facilisis elit diam amet. Vero diam labore no diam consetetur aliquyam dolor illum sit duis lorem sea minim duo ea. Te sit ut sea justo at et nonummy sit et.