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