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