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