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