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