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