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