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