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