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