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