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