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