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