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