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