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