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