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