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