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