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