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