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