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