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