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