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