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