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