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