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