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