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