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