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