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