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