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