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