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