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