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