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