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