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