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