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