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