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