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