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