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