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