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