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