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