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