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