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