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