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