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