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