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