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