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