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