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