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