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