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