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