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