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