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