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