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