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