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