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