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