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