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