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