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