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