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