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