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