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