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