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