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