PDF Properties
Using a custom set of XML tags inside your HTML, you can insert both custom metadata as well as instructions for how the PDF would be viewed in a PDF viewer application (subject of course to that application supporting those features).
Options
You use the (optional) tag <pdfproperties> and within that tag you
can insert <metainfo> and <pdfpreferences>
sections as shown in the instructions below. Within the
<metainfo> tag, you can add <prop> tags
with @name, @value attribute pairs with the data you wish
to store in the PDF metadata. Anything without one of the recognized, standard PDF
names (author, title, subject,
creator, keywords) are stored in custom metadata in
the PDF.
The <pdfpreferences> section allows you to insert one or more
<pref> tags with specific @name,
@value pairs that control the way the resulting PDF is displayed
with a viewer that supports standard PDF view attributes. The support
name, @value pairs are listed below and grouped into
all the available categories:
General PDF Options
These options let you control some general information about the generated PDF.
bookmarks - sets whether PDF bookmarks are generated or not. The default
is "false" for Cloudformatter. You can set @value to "true" if you want
bookmarks in PDF. Note that bookmarks are only generated for interpreted
hierarchical information. All h1 elements and there following
h2 elements and so on. Skipping levels will break the sequence and
the bookmarks will not be correct.
pdf-version - sets the PDF version number. The default is version 1.5
for Cloudformatter but you set @value to values like "1.3", "1.4",
"1.6" or "1.7" if you wish to change the version. Be aware thar some other features
could be disabled by setting the version too low.
compress - sets whether the PDF is compressed or not. The default is
"true" for Cloudformatter. You can set @value to "false" if you want
uncompressed PDF.
linearize - sets whether the PDF is linearized or not. The default is
"false" for Cloudformatter. You can set @value to "true" if you want to
optimize a long PDF for web view.
PDF View Options
These options let you control how the PDF when opened appears to the end user.
view-mode - Choose from one of the following:
auto- If there are bookmarks in the document, the bookmarks pane is displayed. Otherwise, all auxiliary panes are hidden.show-none- All auxiliary panes are hidden.show-bookmarks- The bookmarks pane is displayed.show-thumbnails- The thumbnails pane is displayed.full-screen- The document is displayed in full screen-mode.
initial-zoom - Choose from one of the following:
auto- Page scaling is not specified.fit- The page is scaled to fit completely into the view port.fit-width- The page is scaled so that its width matches the width of the view port.fit-height- The page is scaled so that its height matches the height of the view port.###or####%- The page is scaled by the number or percentage specified.
page-layout - Choose from one of the following:
auto- Uses settings of viewer application.single-page- Displays one page at a time.continuous- Displays pages continuously in one column.two-columns-left- Displays pages continuously in two columns, with odd-numbered pages to the left.two-columns-right- Displays pages continuously in two columns, with odd-numbered pages to the right.two-pages-left- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the left.two-pages-right- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the right.
viewer-preferences - A comma separated list of the following
possibilities:
hide-toolbar- Hides the viewer application's tool bars when the document is active.hide-menubar- Hides the viewer application's menu bar when the document is active.hide-window-ui- Hides user interface elements in the document's window (such as scroll bars and navigation controls), leaving only the document's contents displayed.fit-window- Resizes the document's window to fit the size of the first displayed page.center-window- Positions the document's window in the center of the screen.display-document-title- Controls whether the window's title bar displays the document title taken from the "title" metadata field.
PDF Security
These options allow you to specify owner and user security in the PDF output. User-level security can inject a password to be used to open the PDF, while owner-level security can control what can be done with the PDF (like printing it or copying the data from it).
userpassword - Sets the user password that must be entered to view the
PDF. There are no options, the @value passed is the password to be
used.
ownerpassword - Sets the owner password that must be entered to enable
advanced processing of the PDF. There are no options, the @value passed
is the password to be used. An ownerpassword is used to lock down certain privledges
that an owner will grant to a recipient of the PDF. Without the owner password,
recipients can be restricted from certain things. By default they are restricted
from everything, and you can then specify what additional things you allow by using
userpriviledges.
userpriviledges - A comma separated list of the following
possibilities:
print- Enables printing the document.modify- Enables editing the document.copy- Enables copying text and images from the document to the clipboard.annotate- Enables adding notations to the document and changing the field values.
PDF Pre-Press Options
These allow you to specify crop marks, bleeds and registration marks to be applied to the PDF.
crop-offset - specify offsets from the meaningful content on the page to
the edges of the physical media (/MediaBox entry in the PDF page dictionary). Its
value is a series of 1 to 4 length specifiers that set offsets from the edges of the
page area to the corresponding edges of the /MediaBox. Rules for expanding the value
are the same as for the padding property in CSS.
bleed - specify the bleeds — an extra space around the page area into
which the contents of the page may protrude (/BleedBox entry in the PDF page
dictionary). Its value is a series of 1 to 4 length specifiers that set offsets from
the edges of the page area to the corresponding edges of the /BleedBox. Rules for
expanding the value are the same as for the padding property in CSS.
crop-mark-width - defines line width for the crop marks, setting it to 0
disables drawing of crop marks.
bleed-mark-width - defines line width for the bleed marks, setting it to
0 disables drawing of bleed marks.
printer-mark - specify additional SVG images to be drawn in the offset
area surrounding the page (specified by crop-offset and bleed parameters). Printer
marks are clipped to the outside of the bleed rectangle. The @value is
a URL to an SVG you have. This sample has two URLs (one for a colorbar and one for a
registration mark) you can also use if you like.
The following code is what is behind this page for producing the PDF. Of course, you would only see the things supported by your PDF viewer you use. If you wish to see them all in action, then use "download" and Adobe Reader to view the PDF.
Recent changes in some browsers will not treat this XML as XML. Instead it tries (incorrectly) to not close tags. For best results, be sure to use open and close tags and not a self-closing tag.
<pdfproperties style="display:none;">
<metainfo>
<prop name="author" value="Xportability LLC"></prop>
<prop name="title"
value="Xportability Cloudformatter: Showing Custom
PDF Properties"></prop>
<prop name="subject" value="A Cloudformatter Document"></prop>
<prop name="creator" value="css2pdf@cloudformatter.com"></prop>
<prop name="keywords" value="CSS, PDF, Cloudformatter"></prop>
<prop name="custom1" value="value1"></prop>
<prop name="custom2" value="value2"></prop>
<prop name="custom3" value="value3"></prop>
<prop name="custom4" value="value4"></prop>
</metainfo>
<pdfpreferences>
<pref name="bookmarks" value="true"></pref>
<pref name="pdf-version" value="1.6"></pref>
<pref name="view-mode" value="auto"></pref>
<pref name="initial-zoom" value="fit-height"></pref>
<pref name="page-layout" value="two-columns-left"></pref>
<pref name="viewer-preferences" value="display-document-title"></pref>
<pref name="crop-offset" value="0.5in"></pref>
<pref name="crop-mark-width" value="1px"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/registration.svg"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/colorbar.svg"></pref>
</pdfpreferences>
</pdfproperties>
Sample Output H2
Lorem aliquyam et dolores et dolores dolor ut labore consectetuer diam amet labore dolor minim cum dolor sit. Duo ea ut sadipscing ex wisi dolor facilisis eu consectetuer quis. Et gubergren vulputate et sadipscing consectetuer ut gubergren quis aliquam erat sadipscing sed ut odio et nihil. Aliquyam tincidunt et justo enim hendrerit illum sit et sit et eirmod. Dolores mazim eirmod vero possim in takimata justo duo diam ut consetetur magna dolor. Et consetetur consetetur dolor et dolor et. Et dolore ea stet eirmod dolor. Eirmod rebum eros sea sit justo lobortis.
Takimata justo ut clita accusam in eu et amet sed option voluptua sea eos accusam dolor nihil et et. Vero aliquyam tempor est eirmod sanctus nonumy tempor takimata eum sed nulla. Clita suscipit diam clita sea aliquyam blandit et dolore dolores sit ipsum velit et diam odio. Laoreet dolor vero sit sea nibh ipsum eu at enim lorem elitr et amet. Sanctus diam sit consequat consetetur nonumy velit stet ea. Elitr clita sed takimata ut duis ipsum ut qui sadipscing eum ipsum ipsum lorem. Accumsan commodo et ea ex diam diam duo doming sed at sit nibh eros et et kasd.
Sample Output H3
Et delenit clita dolore sed. Ut te facilisi sed eirmod. Aliquyam elitr sit lorem vero ullamcorper consequat sit sea. Amet rebum et lorem nisl et est lorem no ea sed amet tempor ipsum nihil aliquyam. Sit et magna labore diam.
Dolor est at dolor no sit duo erat dolor option et feugiat liber. Magna stet est lorem eleifend sea sed cum lorem ea lorem. Ad consequat clita consetetur justo sit facilisi imperdiet sanctus ea diam eirmod consetetur stet nonummy et ipsum. Dolores magna mazim duo esse accusam takimata delenit. Et gubergren clita amet consetetur amet et facilisis accusam amet justo dolore justo vero. Enim magna et in quod molestie exerci erat dignissim kasd sed vero qui et no ut duo ut sanctus.
Sample Output H4
Ad lorem stet consectetuer sed labore at amet quis diam ipsum sea. Commodo iusto est ea accusam nulla odio magna in dolores. At ea dolore dolore facilisi ut takimata. Zzril placerat lorem aliquip sed no zzril ipsum stet erat elitr sanctus duis dolores invidunt. Eirmod odio duo ut dolore odio suscipit. Feugiat feugait lobortis adipiscing ut. Kasd stet ipsum volutpat. Elitr commodo nonumy sed id eos justo duo ipsum eleifend dolore clita sea aliquyam enim sadipscing invidunt amet. Rebum sed invidunt kasd justo eirmod et ut praesent diam dolor vel.
At sadipscing ut dolore amet vulputate aliquyam no lorem blandit accusam ut vel rebum sit ipsum dignissim at. Erat nisl ea takimata dolore justo eos vero nonumy ipsum elitr. Ipsum vero ipsum illum. Dolores gubergren ullamcorper kasd consetetur est vero sit voluptua labore accumsan liber labore ea. Autem ut sea at no ut. Adipiscing justo consequat suscipit eirmod clita dolores tempor clita rebum aliquyam sit qui gubergren zzril sit lorem soluta diam.
Sample Output H4
Ut et lorem suscipit takimata ea vero duo dolores elitr ullamcorper et ipsum sed et. Vel amet stet sit facilisi eos voluptua facilisis eirmod dolore. Iriure duo odio eos justo diam stet dolor sanctus. Lorem erat voluptua clita blandit consetetur sed in exerci accusam magna rebum et wisi praesent sed sed ad. Vulputate kasd dolores nihil erat euismod sit no aliquam placerat ullamcorper illum. Ad ea luptatum accusam tempor et nonumy. Lorem tempor amet diam sit amet.
Sanctus diam in dolore. Ut ipsum dignissim sit diam wisi blandit. Accusam sit dolor lorem amet. At ipsum amet elitr duo. Eu tempor eos eos takimata lorem sanctus est.
Sample Output H3
Eleifend et ut stet rebum stet kasd in sit laoreet nonumy ea consectetuer sed. Elit duo eleifend velit amet consetetur lorem qui eos et rebum erat sed. Justo diam delenit laoreet nonummy ea aliquyam nonumy magna liber clita elitr at amet ea. Enim magna et autem iriure dolor duis et quis justo consequat dignissim aliquyam sed amet. Stet erat diam dolore at kasd sanctus te duis autem. Consetetur tincidunt in duo est nonumy sit eos no dolor ut dolor dolor euismod magna. Exerci delenit erat no facilisis accusam dolor erat dolor duo et consequat diam wisi sanctus tempor sit ipsum blandit. Et sit kasd ea sed vulputate diam consectetuer. Facilisis sea et facilisis lorem wisi sit dolores dolore erat aliquam no zzril et molestie takimata aliquam.
Quis ipsum sanctus lorem at exerci sit sea. Stet magna elitr amet duis. Dolor no gubergren dolores. Ipsum gubergren sit euismod zzril. Kasd clita sanctus at no diam lorem labore voluptua magna volutpat no consequat accusam lorem sea consetetur lobortis et. Vero soluta minim duo duis magna et voluptua laoreet sit. Clita dolor sit ipsum no sit at laoreet sed et et magna duo justo. Eos vel liber sit dolore labore lobortis invidunt takimata no velit kasd elit erat. Sed dolore voluptua invidunt feugait facilisis eleifend vero consetetur kasd lorem magna. Lobortis takimata dolore.
Sample Output H4
Rebum ipsum vero et facilisis duo clita eos et diam eirmod nonumy ut et consetetur ut sadipscing hendrerit. Dolore nulla takimata feugiat et clita ut et tempor ut dolor. Diam hendrerit clita sit aliquyam aliquyam no ipsum. Accumsan invidunt kasd kasd ut sanctus voluptua et liber consetetur veniam consequat liber aliquyam vulputate sanctus duo dolores. Elitr dolor no eum justo eos amet duis vero.
Takimata ut invidunt eirmod elitr elitr vel diam tempor sanctus no blandit minim dolores eu lorem. Clita hendrerit amet clita sit consequat kasd est ea eos sed eirmod no tincidunt ipsum. Voluptua ut dolor amet dolores nisl eirmod suscipit rebum dolor molestie amet nobis sed ipsum. Vero lorem illum ipsum accusam duo erat et takimata vel diam duo vulputate lorem duis dolor. Dolor invidunt eos eirmod enim diam sed takimata accusam ipsum ad sit kasd et erat at lorem eu.
Sample Output H4
Enim sit vero est elitr sed blandit rebum ea justo sit sit invidunt consetetur labore eirmod et et. Ea consetetur dolor amet accusam adipiscing accumsan commodo. Ipsum elitr amet luptatum sed lorem takimata et et nulla veniam nibh est kasd voluptua ipsum feugiat feugiat. Praesent eirmod autem no ipsum sed takimata enim est erat. Sadipscing blandit exerci hendrerit nulla et amet et te accusam ut sed eos lobortis cum ea in. Accusam autem sea ea labore eum et takimata labore dolor vero labore. Ipsum diam clita labore kasd rebum augue accusam et. Rebum et magna dolor kasd. Tempor tempor eros. Ut labore illum facilisis diam ut magna ut commodo nonumy ipsum no exerci.
Sit gubergren tincidunt in dolores magna clita ipsum kasd. Dolor adipiscing elit clita magna dolor gubergren lorem ex. Justo enim labore accumsan sed et sed dignissim labore ut est erat dolor. Gubergren et diam ad gubergren duo eos ut aliquam et amet eirmod. Eos ut at iriure gubergren sea dolore illum tempor tation lorem ea dolor ipsum voluptua rebum. Lorem labore eu lorem dolor et ut et nisl clita no et. Rebum diam nonumy. Eirmod ut diam kasd consetetur accusam.
More Sample Output H2
Vero eos vel ipsum no et. Et sadipscing lorem ut ut clita et. Takimata voluptua justo odio dolor soluta. Nihil gubergren sadipscing nobis autem at tempor dolores kasd stet. Facilisis dolor clita vulputate ut congue lorem amet gubergren dolor lorem vero. Eirmod et amet et labore facer duis ipsum amet rebum voluptua aliquam. Euismod praesent sea ea. Nonumy et dolor suscipit placerat at esse sed et. Tempor facilisi nisl augue aliquip eum. Ea sed dolores consectetuer hendrerit magna takimata. Amet ipsum ea no eos est at te tempor at dolor erat sit eros vero dolores.
Ipsum et assum elitr stet duo. Clita justo dolores duo clita amet sed kasd et no nonumy eirmod eum amet illum sed dolore. Justo soluta soluta sit esse et amet possim suscipit amet sed exerci at eos. Et consetetur tempor in elitr dolore. Gubergren duo diam blandit invidunt.
Sample Output H3
Erat invidunt eirmod takimata clita consetetur molestie accumsan labore rebum duo dolor facer. Nulla et vel amet esse sed tincidunt nulla consetetur et et ipsum ut iriure molestie et accusam magna. Vero sed ipsum tempor nonumy feugiat et eos wisi gubergren. Nulla diam ullamcorper blandit commodo. Dolor et blandit labore sed volutpat sea ipsum elit zzril justo sed sed ea sadipscing tempor nibh. Zzril et blandit sadipscing elitr sanctus in gubergren luptatum lorem clita blandit ullamcorper. Sed diam et est elit ea et no nonumy consectetuer. At quis at at sit congue laoreet eu et eirmod. Rebum lorem sea stet sed dolore lorem tempor velit et consetetur ipsum amet eirmod.
Tincidunt amet dolor odio at dolores lorem ad quis accusam ex consequat sanctus ut. Aliquyam dolor suscipit eos justo magna duo vulputate sit est dolor kasd vero aliquam sit takimata ipsum. Consetetur ipsum labore et amet ea. Amet rebum duis no stet dolor dolore ex at rebum sit quis ea. Sea takimata ut esse et est sanctus ipsum consetetur dolor no dolores magna adipiscing sed sanctus nonumy dolor. Vel justo duo dolor ad accusam et accusam eu commodo ullamcorper. Minim odio enim dolor te sit nonumy molestie no at consequat ea et. Dolor et aliquam diam et at. Eos hendrerit diam diam est. Ea minim ut. Lorem tation ipsum sit ad eirmod erat adipiscing euismod.
Sample Output H4
Feugiat lorem labore enim ut ipsum et dolor dignissim nonumy. Magna tempor accusam et rebum clita suscipit takimata et. At nonummy tempor. Stet sed nobis eirmod diam tincidunt. Voluptua tempor te dolores lorem in et tempor vero gubergren consequat nonumy aliquyam voluptua et eu. Duo duo aliquyam est sea augue accusam dolor aliquyam accusam in at et. Dolore zzril dolor sanctus sanctus nulla magna kasd possim invidunt clita sit elit kasd et ut volutpat sit luptatum. Et sanctus amet est consectetuer augue lorem consetetur vero qui duis amet sit sit ipsum dolore. Ipsum est zzril option. Sed diam ut takimata labore. Et delenit invidunt te consetetur lorem consetetur magna eirmod duis ut congue.
Tempor et nonumy. Amet labore sea. At et in dolores velit sit sed volutpat et. Veniam consetetur nostrud sadipscing et dolor duo adipiscing ut dolor stet no et et esse. Accusam takimata eirmod kasd nam lorem accusam option et diam.
Sample Output H4
Ipsum enim dolore et nibh diam et consequat consetetur at liber eirmod takimata diam. Kasd lorem et amet sit erat diam vero accusam. Gubergren lorem nulla diam rebum diam dolor et hendrerit. Ut consequat amet dolore velit nulla eos ipsum consetetur. Sit ipsum ipsum et gubergren labore amet ipsum duo magna accusam sadipscing et sed luptatum.
Kasd aliquyam laoreet nostrud diam ea dolor magna sadipscing ipsum stet clita facilisis takimata sea magna labore. Takimata accusam illum aliquyam stet. Sed ea sed vero eros kasd sed dolores ipsum possim nibh eos possim kasd illum. Option velit consectetuer dolores vel tincidunt gubergren sed rebum amet sanctus ea vero labore lorem eos dolores et erat. Tempor voluptua nonumy dolore sea invidunt sea tempor amet vel elitr vero dolore qui et. Stet imperdiet tation. Magna aliquyam autem eum nonumy feugait quis ipsum lorem dolore dolore accusam dolore sea ut iusto ipsum diam nonummy.
Sample Output H3
Eos aliquyam clita lorem dolore labore sanctus kasd dolore justo. Facilisi vero illum lorem dolor facilisis. Lorem vel est nonumy clita sit magna elitr diam invidunt et feugiat voluptua et lorem sanctus labore. Clita in ullamcorper tation est quis eirmod ad justo dolore takimata placerat. Takimata accusam gubergren feugiat dolores minim ut dolores kasd ut euismod sadipscing lorem sadipscing aliquyam in. Nulla ipsum labore diam diam elit. Takimata diam duis amet duo diam dolor duo.
Gubergren gubergren et. Dolore consetetur lorem dolor lorem takimata aliquyam dolore eleifend duo. Consequat duo gubergren aliquyam takimata sit et et ut accusam sed lorem molestie erat sanctus luptatum sea. Est labore et diam diam in hendrerit dolor dolores eos no dolore et tation amet in diam. Eros aliquyam nostrud dignissim gubergren eirmod kasd assum ipsum amet labore eos ipsum quod eos ut te labore. Sea diam dolor diam vulputate erat voluptua diam ipsum rebum esse lorem facilisi invidunt sit vero sed. Lorem ut magna labore nisl tempor eum sit.
Sample Output H4
Ea dolores et clita iriure velit esse justo vero dolores justo placerat qui elitr augue at sit sed. Eirmod dolor et nibh ut at diam sanctus. Ipsum et ut hendrerit ex dolor magna magna vel sed. Dolor ipsum sed lorem iriure et duis aliquam diam accusam consectetuer invidunt est iriure voluptua eos rebum et labore. Ex sed aliquyam amet elitr eos ipsum tempor volutpat amet feugiat duis consetetur dolore. Diam at dolore amet justo facilisis et dolores esse. Aliquyam autem sit dolore erat invidunt no. Lobortis at eirmod dolores diam takimata illum invidunt vero est facilisis. Dolore eros nonumy dolores dolore ipsum sadipscing est et vero magna aliquyam facilisis erat illum wisi.
Esse sea eirmod diam vulputate sed eirmod et magna rebum vulputate. Lorem gubergren nonumy option eirmod ex. Aliquyam et magna eum ut feugait voluptua gubergren facilisi gubergren sed in. Ut et dolor et et in. Dolore quis gubergren. Consequat dolores lorem aliquam ipsum. Diam at sed consetetur labore no eos molestie. Ea stet minim duis eum consectetuer accusam dolore magna aliquip eu ipsum erat amet. Diam molestie sanctus erat sit odio feugait nonumy.
Sample Output H4
Amet elitr aliquyam lorem. No vero est tempor dolor vero luptatum ea. Diam laoreet sed justo duo et takimata sed et sit et tempor justo sadipscing in. Odio ullamcorper lorem illum magna sed diam tempor labore dolore. Ipsum sadipscing eu quod consetetur et sed tation aliquyam at euismod accusam sit mazim sit clita ut est gubergren. Et dolores eum eros consequat erat magna. Rebum consectetuer diam ut at clita no possim congue odio et ut sanctus duo lorem labore aliquyam in sea. Erat erat accusam et ut et accusam dolore wisi sed kasd rebum sanctus vero imperdiet molestie. Dolor stet labore et et illum ipsum vel eum. Luptatum blandit nostrud sit consetetur et est nisl labore aliquyam vero.
Sed consetetur accusam takimata veniam no aliquyam tempor vulputate elit ea iusto et. Sadipscing lorem feugiat elitr ipsum rebum iriure nonumy dolor gubergren at et. Dolor invidunt nostrud elitr rebum nonummy veniam consetetur nonumy no vero tempor et ipsum gubergren gubergren et consetetur. Eirmod volutpat kasd facilisi ipsum eirmod est sit. Ut aliquyam duis nibh. Duo consetetur dolor sed justo amet diam rebum nulla est suscipit facilisi aliquam.