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