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