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