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