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