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