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