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