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