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