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