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