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