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