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