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