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