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