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