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