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