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