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