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