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