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