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