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