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