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