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