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