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