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