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