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