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