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