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