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