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