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