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