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