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