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