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