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