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