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