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