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