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