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