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