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