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