PDF Properties
Using a custom set of XML tags inside your HTML, you can insert both custom metadata as well as instructions for how the PDF would be viewed in a PDF viewer application (subject of course to that application supporting those features).
Options
You use the (optional) tag <pdfproperties> and within that tag you
can insert <metainfo> and <pdfpreferences>
sections as shown in the instructions below. Within the
<metainfo> tag, you can add <prop> tags
with @name, @value attribute pairs with the data you wish
to store in the PDF metadata. Anything without one of the recognized, standard PDF
names (author, title, subject,
creator, keywords) are stored in custom metadata in
the PDF.
The <pdfpreferences> section allows you to insert one or more
<pref> tags with specific @name,
@value pairs that control the way the resulting PDF is displayed
with a viewer that supports standard PDF view attributes. The support
name, @value pairs are listed below and grouped into
all the available categories:
General PDF Options
These options let you control some general information about the generated PDF.
bookmarks - sets whether PDF bookmarks are generated or not. The default
is "false" for Cloudformatter. You can set @value to "true" if you want
bookmarks in PDF. Note that bookmarks are only generated for interpreted
hierarchical information. All h1 elements and there following
h2 elements and so on. Skipping levels will break the sequence and
the bookmarks will not be correct.
pdf-version - sets the PDF version number. The default is version 1.5
for Cloudformatter but you set @value to values like "1.3", "1.4",
"1.6" or "1.7" if you wish to change the version. Be aware thar some other features
could be disabled by setting the version too low.
compress - sets whether the PDF is compressed or not. The default is
"true" for Cloudformatter. You can set @value to "false" if you want
uncompressed PDF.
linearize - sets whether the PDF is linearized or not. The default is
"false" for Cloudformatter. You can set @value to "true" if you want to
optimize a long PDF for web view.
PDF View Options
These options let you control how the PDF when opened appears to the end user.
view-mode - Choose from one of the following:
auto- If there are bookmarks in the document, the bookmarks pane is displayed. Otherwise, all auxiliary panes are hidden.show-none- All auxiliary panes are hidden.show-bookmarks- The bookmarks pane is displayed.show-thumbnails- The thumbnails pane is displayed.full-screen- The document is displayed in full screen-mode.
initial-zoom - Choose from one of the following:
auto- Page scaling is not specified.fit- The page is scaled to fit completely into the view port.fit-width- The page is scaled so that its width matches the width of the view port.fit-height- The page is scaled so that its height matches the height of the view port.###or####%- The page is scaled by the number or percentage specified.
page-layout - Choose from one of the following:
auto- Uses settings of viewer application.single-page- Displays one page at a time.continuous- Displays pages continuously in one column.two-columns-left- Displays pages continuously in two columns, with odd-numbered pages to the left.two-columns-right- Displays pages continuously in two columns, with odd-numbered pages to the right.two-pages-left- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the left.two-pages-right- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the right.
viewer-preferences - A comma separated list of the following
possibilities:
hide-toolbar- Hides the viewer application's tool bars when the document is active.hide-menubar- Hides the viewer application's menu bar when the document is active.hide-window-ui- Hides user interface elements in the document's window (such as scroll bars and navigation controls), leaving only the document's contents displayed.fit-window- Resizes the document's window to fit the size of the first displayed page.center-window- Positions the document's window in the center of the screen.display-document-title- Controls whether the window's title bar displays the document title taken from the "title" metadata field.
PDF Security
These options allow you to specify owner and user security in the PDF output. User-level security can inject a password to be used to open the PDF, while owner-level security can control what can be done with the PDF (like printing it or copying the data from it).
userpassword - Sets the user password that must be entered to view the
PDF. There are no options, the @value passed is the password to be
used.
ownerpassword - Sets the owner password that must be entered to enable
advanced processing of the PDF. There are no options, the @value passed
is the password to be used. An ownerpassword is used to lock down certain privledges
that an owner will grant to a recipient of the PDF. Without the owner password,
recipients can be restricted from certain things. By default they are restricted
from everything, and you can then specify what additional things you allow by using
userpriviledges.
userpriviledges - A comma separated list of the following
possibilities:
print- Enables printing the document.modify- Enables editing the document.copy- Enables copying text and images from the document to the clipboard.annotate- Enables adding notations to the document and changing the field values.
PDF Pre-Press Options
These allow you to specify crop marks, bleeds and registration marks to be applied to the PDF.
crop-offset - specify offsets from the meaningful content on the page to
the edges of the physical media (/MediaBox entry in the PDF page dictionary). Its
value is a series of 1 to 4 length specifiers that set offsets from the edges of the
page area to the corresponding edges of the /MediaBox. Rules for expanding the value
are the same as for the padding property in CSS.
bleed - specify the bleeds — an extra space around the page area into
which the contents of the page may protrude (/BleedBox entry in the PDF page
dictionary). Its value is a series of 1 to 4 length specifiers that set offsets from
the edges of the page area to the corresponding edges of the /BleedBox. Rules for
expanding the value are the same as for the padding property in CSS.
crop-mark-width - defines line width for the crop marks, setting it to 0
disables drawing of crop marks.
bleed-mark-width - defines line width for the bleed marks, setting it to
0 disables drawing of bleed marks.
printer-mark - specify additional SVG images to be drawn in the offset
area surrounding the page (specified by crop-offset and bleed parameters). Printer
marks are clipped to the outside of the bleed rectangle. The @value is
a URL to an SVG you have. This sample has two URLs (one for a colorbar and one for a
registration mark) you can also use if you like.
The following code is what is behind this page for producing the PDF. Of course, you would only see the things supported by your PDF viewer you use. If you wish to see them all in action, then use "download" and Adobe Reader to view the PDF.
Recent changes in some browsers will not treat this XML as XML. Instead it tries (incorrectly) to not close tags. For best results, be sure to use open and close tags and not a self-closing tag.
<pdfproperties style="display:none;">
<metainfo>
<prop name="author" value="Xportability LLC"></prop>
<prop name="title"
value="Xportability Cloudformatter: Showing Custom
PDF Properties"></prop>
<prop name="subject" value="A Cloudformatter Document"></prop>
<prop name="creator" value="css2pdf@cloudformatter.com"></prop>
<prop name="keywords" value="CSS, PDF, Cloudformatter"></prop>
<prop name="custom1" value="value1"></prop>
<prop name="custom2" value="value2"></prop>
<prop name="custom3" value="value3"></prop>
<prop name="custom4" value="value4"></prop>
</metainfo>
<pdfpreferences>
<pref name="bookmarks" value="true"></pref>
<pref name="pdf-version" value="1.6"></pref>
<pref name="view-mode" value="auto"></pref>
<pref name="initial-zoom" value="fit-height"></pref>
<pref name="page-layout" value="two-columns-left"></pref>
<pref name="viewer-preferences" value="display-document-title"></pref>
<pref name="crop-offset" value="0.5in"></pref>
<pref name="crop-mark-width" value="1px"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/registration.svg"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/colorbar.svg"></pref>
</pdfpreferences>
</pdfproperties>
Sample Output H2
Et dolor aliquip vel diam et congue no ex rebum et diam elitr nostrud lorem aliquyam. Nostrud eum nostrud nonummy no no ea autem ut consetetur hendrerit et ipsum. Sit illum labore feugiat erat consequat possim accusam facilisis nonumy sit adipiscing erat in takimata sadipscing labore consetetur. Consetetur takimata vero dolore ut et tempor invidunt takimata tempor sed no elitr odio. Et hendrerit no labore justo commodo ut iriure nulla et voluptua ullamcorper magna vero in kasd. Sit amet est. Ipsum delenit labore sit. Gubergren magna illum amet erat nostrud sed est. Lorem ut dolores feugait sit no elit dolor vel quod accumsan autem lorem accusam consetetur. Vel elitr commodo.
Erat sea eirmod autem. Possim takimata erat eos vel nonummy voluptua iusto diam diam voluptua consequat lorem sit labore est sit. Sanctus voluptua kasd eum sed ea sit dolores. Delenit et invidunt voluptua erat kasd augue vulputate sed justo diam takimata sed aliquam. Luptatum duo gubergren amet sadipscing liber. Quis sed duo ea nam voluptua sit esse rebum vero justo duo aliquyam invidunt lorem illum dolor laoreet clita. Sadipscing tempor consetetur dolore sed dolore invidunt diam justo. Nonumy vero in facer facilisi sed. Rebum vero dolore sed vero lorem nobis esse euismod diam nulla duis dolores clita in sanctus. Consequat kasd qui.
Sample Output H3
Magna sed justo clita elitr duo sed vero nonumy sed vel. Dolore dolore duis invidunt justo dolore ut consetetur illum dolor. Duo sanctus sadipscing sit blandit stet diam magna laoreet velit. Iriure dolore nonumy erat dolore elit no dolor duo. Aliquyam et erat dolor sea hendrerit feugiat erat diam vero et ea enim justo diam option et erat erat. Lorem sadipscing accusam at. Diam sit nonumy dolor elitr. Consectetuer ut ut nisl labore stet duis dolore accusam tempor tempor autem duo dignissim sed et lorem eos magna.
Voluptua labore rebum nam dolor et sadipscing. Iriure takimata diam labore nonumy sea aliquyam dolor. Et consectetuer dolores ea no in stet autem suscipit aliquip luptatum accusam exerci. Accusam consetetur lorem sed amet. Dolor dolore takimata at et takimata aliquam. Kasd amet magna ipsum duo justo sit magna eleifend ipsum consequat in dolor eos enim duo eros dolor.
Sample Output H4
Sanctus vero ut ipsum. No vulputate nonumy gubergren eros iriure erat et invidunt est te ut blandit dolor nulla. Nonumy euismod vero stet sea et vero consequat accusam ipsum possim takimata at accusam molestie kasd eirmod qui magna. Kasd lorem nonumy dolore sed ut ea vulputate lorem nibh vero. Consetetur at sit aliquyam. Et et ipsum rebum et accusam. Sed clita veniam et. Delenit vero ipsum facilisis elitr est ut. Accusam labore et sit aliquip. Iriure eos velit eum qui ipsum exerci amet. Consectetuer no tempor tation wisi kasd clita vel consetetur lorem consequat sed dignissim voluptua accusam duo dignissim dolore takimata.
Vel ipsum feugait laoreet vel lorem dignissim zzril sea stet sadipscing autem. Esse eirmod sanctus ad. Sadipscing no et et sit et in diam ipsum duo duis ipsum nam. Consetetur option clita clita kasd magna vero sea quis accusam et tempor diam te kasd gubergren. Stet nonumy aliquyam et aliquyam sit. Stet voluptua ut tempor takimata dolor ipsum no tincidunt sadipscing nonumy sed.
Sample Output H4
Quis amet diam invidunt duo stet est rebum vero aliquyam erat ut consequat ex. In duo rebum eos. Lorem vel nulla esse amet sea duo dolore magna sit accusam sit esse nostrud. Nonumy molestie eu nulla lorem laoreet lorem et aliquyam at invidunt aliquam. Lorem autem voluptua voluptua dolor ipsum diam sed eirmod facilisi consequat. Sit stet et diam te duis et elitr dolore odio nonumy takimata ad consetetur aliquyam amet et et stet. Eirmod enim vero.
Amet est ipsum et diam labore magna feugait dignissim sea no et. At facilisis dolore sed hendrerit sed dolor sit nulla. Laoreet nulla clita kasd consetetur. Et duis vel duo amet duis. Ea no tation molestie sea augue dolor clita nisl praesent cum diam duo. Feugiat at illum eirmod odio vel nisl aliquyam magna. Eos ut tempor ipsum tempor mazim ea aliquyam erat et tempor.
Sample Output H3
At ipsum nonumy magna eleifend et. Tempor lorem voluptua gubergren at et dolor. Euismod rebum et qui lorem dolore delenit accusam voluptua ad elitr ea amet eos blandit sit. No aliquyam consetetur et eu eirmod. Rebum rebum ut sea. At volutpat amet facer ut magna ea ex. Dolores diam tation et rebum zzril facilisi dolor eos ipsum elit aliquyam duo aliquip erat hendrerit. Clita no et nam nonumy magna est. Lorem amet et mazim dolores ipsum ipsum.
Sadipscing consectetuer praesent est cum ut stet amet sed erat. Rebum sed dolores at rebum sadipscing nulla sanctus elit veniam iriure et odio takimata et. Gubergren erat sanctus sit in duo gubergren. Dolor gubergren takimata sed est et amet commodo blandit tincidunt. Dolor sed et. Vero no feugiat ut consetetur ea eu. Dolor in justo dolor dolores.
Sample Output H4
Nisl commodo blandit eos vel velit aliquip magna labore lorem ipsum dolor dolore sed erat amet. Duo esse ea et dolor amet et. Ea eos gubergren diam velit sed nonumy at et vero commodo accusam tincidunt tation nonumy est amet. Aliquyam feugait et sit labore consequat sadipscing. Eum option nonumy gubergren takimata et praesent tempor aliquyam at consetetur et dolores consetetur vero ipsum consetetur ipsum aliquyam. Ut voluptua sit diam odio duo invidunt et clita congue commodo eos dolor sea autem.
Kasd sit amet tempor magna sed dolore gubergren no no dignissim ipsum ea lorem. Odio sit diam. Tempor sed dolor. Stet kasd rebum magna. Est nulla no iriure tempor. Dolore ipsum duis eirmod lorem elit enim amet clita est lorem velit sit takimata erat dolor sit feugiat.
Sample Output H4
Sit elitr kasd ipsum at dolores et eirmod tincidunt amet est. Sadipscing et vero diam takimata stet eos voluptua iusto clita hendrerit illum diam aliquam dolores vero consetetur ipsum. Sit labore et lorem ullamcorper sed duis clita tempor tempor nibh et nulla. At enim diam labore. Amet et vero facer lorem et ea sed in labore. Sanctus quis et justo sea takimata nulla accusam lorem invidunt at sit dignissim.
Tempor sit amet at sea sed diam ipsum takimata rebum iusto sanctus clita luptatum gubergren stet. Suscipit ipsum dolore clita assum exerci voluptua dolore eirmod aliquyam labore aliquip invidunt kasd eirmod aliquam facilisi sit lorem. Ea magna diam ea at ipsum est est dolor ea sanctus nonumy eos iusto. Eu invidunt ipsum enim nisl at consetetur et sit sanctus labore accusam dolore labore et. Dignissim diam dolore elitr nonummy vero illum invidunt lorem accusam est ut.
More Sample Output H2
Amet feugiat stet est in dolor nonumy dolor sit ipsum est clita at no hendrerit voluptua eos. Elitr sadipscing et amet magna. Illum est invidunt et voluptua feugiat et takimata. Dolor kasd magna sea diam consetetur molestie et sed eirmod labore. Ut lorem voluptua erat erat ipsum labore tation vel delenit eum clita duo est esse consequat eos. Eirmod ut enim consectetuer takimata lorem sed blandit amet at ut gubergren erat. Dolor quod invidunt velit kasd eirmod ipsum dolore ut dolore amet eirmod lorem sea diam in feugiat.
Accusam illum vulputate in labore aliquyam kasd eirmod kasd ipsum no est dolor ut. Doming quod et ipsum velit consequat nonumy velit dolore. Diam justo lorem dolore. Eos ut sit esse no kasd lorem sit. Takimata amet lorem tempor nulla voluptua at ipsum tempor nulla stet wisi iusto eu ex. Magna erat sanctus eros stet iriure kasd sanctus et autem. Hendrerit ut tation no consequat hendrerit sit tation in odio dolor gubergren. Stet elit dolore lorem justo lorem sit tempor ut diam sed eos elitr at aliquyam dolore. Elitr velit magna duis nonumy feugiat eros nam labore et invidunt justo gubergren tempor quis. Et vero iusto stet eros tempor et stet vero est exerci consequat kasd lobortis duo accusam lorem duo. Adipiscing sed takimata ipsum ipsum diam diam cum sed.
Sample Output H3
At diam consectetuer sed gubergren illum diam rebum nonummy sanctus sanctus justo sadipscing blandit eos. Te erat eos ea dignissim sed diam et elitr autem tempor magna placerat consetetur ea. Ipsum eos aliquyam blandit amet enim amet elit clita ea ullamcorper eirmod voluptua no rebum stet erat sed invidunt. Tempor amet adipiscing et adipiscing amet tempor eu. Takimata sed sit eirmod ipsum et clita sanctus ut kasd sed nisl.
Et lorem possim takimata dolore illum stet facer augue. Sed accusam ipsum te. Eirmod aliquam adipiscing clita elitr liber sed odio adipiscing kasd vulputate at takimata at vel no accusam. Ipsum kasd stet sed iriure est sit duis dolores nostrud sadipscing gubergren consetetur accusam feugait no velit elitr. Lorem volutpat et elitr dolore lorem sit voluptua qui takimata et. Ipsum sea vero.
Sample Output H4
Duo sit diam nibh eum quis lorem labore diam euismod blandit. Justo dolor eirmod no stet commodo option eirmod amet lorem. Sit vel et accusam invidunt adipiscing amet ut et magna erat no diam ea eirmod amet ipsum. No odio ipsum clita et adipiscing no. Et tempor sed quod et stet invidunt sea autem erat aliquyam sea ut adipiscing dolore sed sed. Vero nonumy luptatum sadipscing vero lorem dolore assum euismod nonummy eos ut diam feugiat clita no wisi sed takimata. Sit ea vero vel sit no rebum amet te sadipscing dolore.
Vulputate voluptua et diam voluptua aliquyam vero dolor. Justo nibh ut delenit diam vel. Voluptua et sanctus labore. Dolore diam lorem ut elitr ea possim luptatum sadipscing et ipsum illum diam sit est elitr. Aliquyam sit dolore vel dolor dolor kasd ipsum liber et. Amet dolore nonumy et diam at takimata volutpat facer consetetur duo autem lorem. Nonumy dolore magna erat at eirmod vero lorem dolor ea dolor sit feugait congue magna dolore et. Sit nonumy commodo gubergren magna justo autem rebum sadipscing sanctus qui lorem et dolore clita. Stet augue vero aliquyam magna magna eos nonumy est ut ut. Et tempor vulputate nulla accumsan stet accusam dolore ea erat dolore qui vero consetetur eum.
Sample Output H4
Sadipscing consetetur dolor nonumy consetetur invidunt esse eos diam vero magna lorem sanctus velit et nonummy. Ipsum lorem duo clita congue sea gubergren veniam duo molestie sadipscing vero sanctus tempor ea ipsum. Stet rebum clita eos eos sea ipsum ut dolore nonumy sanctus et sadipscing sed option vero amet stet. Tempor takimata euismod invidunt dolore. Diam consequat sadipscing ea labore molestie sit stet aliquyam tation eros wisi at takimata. Et diam ea ex est. Vero sadipscing minim amet sanctus vero. Lorem justo dolor sed feugait eirmod vel sanctus vero dignissim lorem velit. Ipsum sit commodo et eos at tempor lorem magna rebum facilisis sit adipiscing sed dolor kasd magna. Sanctus clita placerat duis sea elitr eos at invidunt.
Ut takimata sit duo facilisis duis sed amet possim duis magna. Justo vel et magna diam stet feugiat nulla amet duis sanctus eirmod magna molestie et aliquip diam suscipit dolor. Consetetur erat dolor vero aliquyam labore sit et vero zzril gubergren dolor et eros et dolor erat cum. Stet nulla magna feugait doming sit sit minim elitr takimata sadipscing et. Lorem elitr tation sit. Sit vel nostrud amet iriure takimata ipsum et lorem elitr stet wisi et. Volutpat eirmod illum. Ad sea consectetuer voluptua dolores odio no mazim rebum.
Sample Output H3
Lorem tempor amet accusam consequat est gubergren hendrerit ipsum magna eum amet. Dolor cum option duis eirmod gubergren dolor tation vel erat ipsum sadipscing sed amet ut sanctus. Ipsum mazim sanctus diam sit eos stet consetetur et eum dolore duis ipsum rebum. Diam veniam voluptua et takimata vel qui ut nonumy justo velit sanctus dolor sed ipsum sed dolor ut invidunt. Sit eirmod et aliquyam magna consectetuer dolor.
Gubergren ea ut volutpat sed et et. Feugiat amet ipsum dolores justo. Et aliquyam dolores kasd et aliquyam et gubergren tation sit ut duo sea sadipscing erat. Hendrerit et delenit at augue esse nonumy facilisi vero magna feugiat sed eos invidunt dolore aliquyam dolore vulputate. Lorem vel vulputate justo at stet et ut assum vel gubergren dolore erat nonumy gubergren et placerat. Consetetur tempor ut sed gubergren eirmod ut lorem sed. Et consequat aliquam invidunt ipsum magna erat est zzril sea accumsan illum adipiscing ea adipiscing voluptua. Erat dolor aliquip eu velit diam. Magna invidunt euismod sea invidunt molestie duo. Labore aliquyam ipsum. No vero duo ipsum no est zzril no erat vel eos tempor et ut takimata sanctus magna autem.
Sample Output H4
Hendrerit gubergren elit duo accusam. Duo clita eum. Dolor nobis dolores facilisis amet nonumy clita ipsum placerat. No id adipiscing sed stet et luptatum dolore no. Augue eirmod voluptua. Illum ipsum sanctus sit imperdiet tempor aliquip nisl accusam ipsum consectetuer in invidunt nonummy ipsum duo amet nonummy. Consetetur tincidunt lorem amet.
Sit diam et dolore consectetuer ut sea at accusam ipsum ut dolore dolor et cum eos magna velit. Sed placerat sanctus et et sit dolores tempor labore dolore tempor et iusto lobortis clita. Eu iusto erat vero stet nonummy magna et consectetuer sit nisl. Invidunt justo et est sadipscing vero ipsum consectetuer nonumy invidunt lorem invidunt ea ipsum vero diam praesent autem. Eirmod praesent at tempor. Ipsum ex takimata sed sed diam suscipit et ut dolores ut dolore gubergren. Sed autem consetetur vel veniam elit tincidunt amet elitr rebum ipsum vulputate dolore.
Sample Output H4
Blandit aliquip kasd. Erat dolor elitr duo zzril vero lorem delenit et eum. Rebum nulla esse dolor nulla amet sed justo eos et amet invidunt lobortis. Stet et eros odio kasd dolore amet sadipscing ipsum magna. Dolore feugiat sed at veniam magna nulla nonumy clita dolores dolor ipsum magna. Lorem sanctus adipiscing erat diam elitr amet justo vero et molestie elitr elitr est et rebum est ullamcorper.
Autem ex gubergren. Accusam vel est stet erat consetetur blandit et doming veniam. Et ipsum no dolor dolor feugiat erat takimata no diam justo eirmod. Dolores congue amet vero diam kasd. Eirmod tation dolores elitr iriure liber erat vero magna sit. Sit dolor dolores nonumy clita nostrud ullamcorper rebum.