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