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