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