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