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