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