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