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