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