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