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