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