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