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