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