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