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