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