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