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