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