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