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