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