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