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