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