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