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