1
<?xml version="1.0" encoding="ASCII"?>
4
<title>Website Parameter Reference</title>
5
<releaseinfo role="meta">
6
$Id: param.xweb 7076 2007-07-18 16:20:33Z xmldoc $
10
<surname>Walsh</surname>
11
<firstname>Norman</firstname>
15
<year>2002-2005</year>
16
<holder>Norman Walsh</holder>
19
<para>This is reference documentation for all user-configurable
20
parameters in the DocBook XSL Website stylesheet (for
21
generating websites from DocBook XML sources). Note that the
22
Website stylesheet is a customization layer of the DocBook XSL
23
HTML stylesheet. Therefore, in addition to the
24
Website-specific parameters listed in this section, you can
25
also use a number of <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../html/">HTML
26
stylesheet parameters</link> to control Website output.</para>
29
<reference xml:id="general">
30
<title>General Parameters</title>
31
<refentry version="5.0" xml:id="autolayout-file">
33
<refentrytitle>autolayout-file</refentrytitle>
34
<refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo>
37
<refname>autolayout-file</refname>
38
<refpurpose>Identifies the autolayout.xml file</refpurpose>
42
<programlisting xml:id="autolayout-file.frag">
43
<xsl:param name="autolayout-file">autolayout.xml</xsl:param>
47
<refsection><info><title>Description</title></info>
48
<para>When the source pages are spread over several directories, this
49
parameter can be set (for example, from the command line of a batch-mode
50
XSLT processor) to indicate the location of the autolayout.xml file.</para>
51
<para>FIXME: for browser-based use, there needs to be a PI for this...
56
<refentry version="5.0" xml:id="body.attributes">
58
<refentrytitle>body.attributes</refentrytitle>
59
<refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
62
<refname>body.attributes</refname>
63
<refpurpose>DEPRECATED</refpurpose>
67
<programlisting xml:id="body.attributes.frag">
68
<xsl:attribute-set name="body.attributes">
69
<xsl:attribute name="bgcolor">white</xsl:attribute>
70
<xsl:attribute name="text">black</xsl:attribute>
71
<xsl:attribute name="link">#0000FF</xsl:attribute>
72
<xsl:attribute name="vlink">#840084</xsl:attribute>
73
<xsl:attribute name="alink">#0000FF</xsl:attribute>
74
</xsl:attribute-set>
78
<refsection><info><title>Description</title></info>
79
<para>DEPRECATED</para>
83
<refentry version="5.0" xml:id="currentpage.marker">
85
<refentrytitle>currentpage.marker</refentrytitle>
86
<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
89
<refname>currentpage.marker</refname>
90
<refpurpose>The text symbol used to mark the current page</refpurpose>
94
<programlisting xml:id="currentpage.marker.frag">
95
<xsl:param name="currentpage.marker">@</xsl:param>
99
<refsection><info><title>Description</title></info>
100
<para>Character to use as identifying the current page in </para>
104
<refentry version="5.0" xml:id="dry-run">
106
<refentrytitle>dry-run</refentrytitle>
107
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
110
<refname>dry-run</refname>
111
<refpurpose>Indicates that no files should be produced</refpurpose>
114
<programlisting xml:id="dry-run.frag">
115
<xsl:param name="dry-run" select="0"></xsl:param>
118
<refsection><info><title>Description</title></info>
119
<para>When using the XSLT processor to manage dependencies and construct
120
the website, this parameter can be used to suppress the generation of
121
new and updated files. Effectively, this allows you to see what the
122
stylesheet would do, without actually making any changes.</para>
123
<para>Only applies when XSLT-based chunking is being used.</para>
127
<refentry version="5.0" xml:id="feedback.href">
129
<refentrytitle>feedback.href</refentrytitle>
130
<refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>
133
<refname>feedback.href</refname>
134
<refpurpose>HREF (URI) for feedback link</refpurpose>
138
<programlisting xml:id="feedback.href.frag">
139
<xsl:param name="feedback.href"></xsl:param>
143
<refsection><info><title>Description</title></info>
144
<para>The <varname>feedback.href</varname> value is used as the value
145
for the <tag class="attribute">href</tag> attribute on the feedback
146
link. If <varname>feedback.href</varname>
147
is empty, no feedback link is generated.</para>
151
<refentry version="5.0" xml:id="feedback.link.text">
153
<refentrytitle>feedback.link.text</refentrytitle>
154
<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
157
<refname>feedback.link.text</refname>
158
<refpurpose>The text of the feedback link</refpurpose>
162
<programlisting xml:id="feedback.link.text.frag">
163
<xsl:param name="feedback.link.text">Feedback</xsl:param>
167
<refsection><info><title>Description</title></info>
168
<para>The contents of this variable is used as the text of the feedback
169
link if <varname>feedback.href</varname> is not empty. If
170
<varname>feedback.href</varname> is empty, no feedback link is
175
<refentry version="5.0" xml:id="feedback.with.ids">
177
<refentrytitle>feedback.with.ids</refentrytitle>
178
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
181
<refname>feedback.with.ids</refname>
182
<refpurpose>Toggle use of IDs in feedback</refpurpose>
186
<programlisting xml:id="feedback.with.ids.frag">
187
<xsl:param name="feedback.with.ids" select="0"></xsl:param>
191
<refsection><info><title>Description</title></info>
192
<para>If <varname>feedback.with.ids</varname> is non-zero, the ID of the
193
current page will be added to the feedback link. This can be used, for
194
example, if the <varname>feedback.href</varname> is a CGI script.</para>
198
<refentry version="5.0" xml:id="filename-prefix">
200
<refentrytitle>filename-prefix</refentrytitle>
201
<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
204
<refname>filename-prefix</refname>
205
<refpurpose>Prefix added to all filenames</refpurpose>
209
<programlisting xml:id="filename-prefix.frag">
210
<xsl:param name="filename-prefix"></xsl:param>
214
<refsection><info><title>Description</title></info>
215
<para>To produce the <quote>text-only</quote> (that is, non-tabular) layout
216
of a website simultaneously with the tabular layout, the filenames have to
217
be distinguished. That's accomplished by adding the
218
<varname>filename-prefix</varname> to the front of each filename.</para>
222
<refentry version="5.0" xml:id="footer.hr">
224
<refentrytitle>footer.hr</refentrytitle>
225
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
228
<refname>footer.hr</refname>
229
<refpurpose>Toggle <HR> before footer</refpurpose>
233
<programlisting xml:id="footer.hr.frag">
234
<xsl:param name="footer.hr" select="1"></xsl:param>
238
<refsection><info><title>Description</title></info>
239
<para>If non-zero, an <HR> is generated at the bottom of each web page,
240
before the footer.</para>
244
<refentry version="5.0" xml:id="header.hr">
246
<refentrytitle>header.hr</refentrytitle>
247
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
250
<refname>header.hr</refname>
251
<refpurpose>Toggle <HR> after header</refpurpose>
255
<programlisting xml:id="header.hr.frag">
256
<xsl:param name="header.hr" select="1"></xsl:param>
260
<refsection><info><title>Description</title></info>
261
<para>If non-zero, an <HR> is generated at the bottom of each web page,
262
before the footer.</para>
266
<refentry version="5.0" xml:id="output-root">
268
<refentrytitle>output-root</refentrytitle>
269
<refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo>
272
<refname>output-root</refname>
273
<refpurpose>Specifies the root directory of the website</refpurpose>
277
<programlisting xml:id="output-root.frag">
278
<xsl:param name="output-root">.</xsl:param>
282
<refsection><info><title>Description</title></info>
283
<para>When using the XSLT processor to manage dependencies and construct
284
the website, this parameter can be used to indicate the root directory
285
where the resulting pages are placed.</para>
286
<para>Only applies when XSLT-based chunking is being used.</para>
290
<refentry version="5.0" xml:id="rebuild-all">
292
<refentrytitle>rebuild-all</refentrytitle>
293
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
296
<refname>rebuild-all</refname>
297
<refpurpose>Indicates that all files should be produced</refpurpose>
301
<programlisting xml:id="rebuild-all.frag">
302
<xsl:param name="rebuild-all" select="0"></xsl:param>
306
<refsection><info><title>Description</title></info>
307
<para>When using the XSLT processor to manage dependencies and construct
308
the website, this parameter can be used to regenerate the whole website,
309
updating even pages that don't appear to need to be updated.</para>
310
<para>The dependency extension only looks at the source documents. So
311
if you change something in the stylesheet, for example, that has a global
312
effect, you can use this parameter to force the stylesheet to rebuild the
315
<para>Only applies when XSLT-based chunking is being used.</para>
319
<refentry version="5.0" xml:id="sequential.links">
321
<refentrytitle>sequential.links</refentrytitle>
322
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
325
<refname>sequential.links</refname>
326
<refpurpose>Make sequentional links?</refpurpose>
330
<programlisting xml:id="sequential.links.frag">
331
<xsl:param name="sequential.links" select="0"></xsl:param>
335
<refsection><info><title>Description</title></info>
340
<refentry version="5.0" xml:id="suppress.homepage.title">
342
<refentrytitle>suppress.homepage.title</refentrytitle>
343
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
346
<refname>suppress.homepage.title</refname>
347
<refpurpose>Suppress title on homepage?</refpurpose>
351
<programlisting xml:id="suppress.homepage.title.frag">
352
<xsl:param name="suppress.homepage.title" select="1"></xsl:param>
356
<refsection><info><title>Description</title></info>
357
<para>FIXME:If non-zero, the title on the homepage is suppressed?</para>
361
<refentry version="5.0" xml:id="table.spacer.image">
363
<refentrytitle>table.spacer.image</refentrytitle>
364
<refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo>
367
<refname>table.spacer.image</refname>
368
<refpurpose>Invisible pixel for tabular accessibility</refpurpose>
372
<programlisting xml:id="table.spacer.image.frag">
373
<xsl:param name="table.spacer.image">graphics/spacer.gif</xsl:param>
377
<refsection><info><title>Description</title></info>
378
<para>This is the 1x1 pixel, transparent pixel used for <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://diveintoaccessibility.org/day_10_presenting_your_main_content_first.html">the table trick</link> to increase the accessibility of the tabular
379
website presentation.</para>
384
<reference xml:id="nav">
385
<title>Navigation Parameters</title>
386
<refentry version="5.0" xml:id="banner.before.navigation">
388
<refentrytitle>banner.before.navigation</refentrytitle>
389
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
392
<refname>banner.before.navigation</refname>
393
<refpurpose>Put banner before navigation?</refpurpose>
397
<programlisting xml:id="banner.before.navigation.frag">
398
<xsl:param name="banner.before.navigation" select="1"></xsl:param>
402
<refsection><info><title>Description</title></info>
407
<refentry version="5.0" xml:id="navbgcolor">
409
<refentrytitle>navbgcolor</refentrytitle>
410
<refmiscinfo class="other" otherclass="datatype">color</refmiscinfo>
413
<refname>navbgcolor</refname>
414
<refpurpose>The background color of the navigation TOC</refpurpose>
418
<programlisting xml:id="navbgcolor.frag">
419
<xsl:param name="navbgcolor">#4080FF</xsl:param>
423
<refsection><info><title>Description</title></info>
424
<para>The background color of the navigation TOC.</para>
425
<para>Only applies with the tabular presentation is being used.</para>
429
<refentry version="5.0" xml:id="navbodywidth">
431
<refentrytitle>navbodywidth</refentrytitle>
432
<refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
435
<refname>navbodywidth</refname>
436
<refpurpose>Specifies the width of the navigation table body</refpurpose>
440
<programlisting xml:id="navbodywidth.frag">
441
<xsl:param name="navbodywidth"></xsl:param>
445
<refsection><info><title>Description</title></info>
446
<para>The width of the body column.</para>
447
<para>Only applies with the tabular presentation is being used.</para>
451
<refentry version="5.0" xml:id="nav.table.summary">
453
<refentrytitle>nav.table.summary</refentrytitle>
454
<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
457
<refname>nav.table.summary</refname>
458
<refpurpose>HTML Table summary attribute value for navigation tables</refpurpose>
462
<programlisting xml:id="nav.table.summary.frag">
463
<xsl:param name="nav.table.summary">Navigation</xsl:param>
467
<refsection><info><title>Description</title></info>
468
<para>The value of this parameter is used as the value of the table
469
summary attribute for the navigation table.</para>
470
<para>Only applies with the tabular presentation is being used.</para>
474
<refentry version="5.0" xml:id="navtocwidth">
476
<refentrytitle>navtocwidth</refentrytitle>
477
<refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
480
<refname>navtocwidth</refname>
481
<refpurpose>Specifies the width of the navigation table TOC</refpurpose>
485
<programlisting xml:id="navtocwidth.frag">
486
<xsl:param name="navtocwidth">220</xsl:param>
490
<refsection><info><title>Description</title></info>
491
<para>The width, in pixels, of the navigation column.</para>
492
<para>Only applies with the tabular presentation is being used.</para>
496
<refentry version="5.0" xml:id="textbgcolor">
498
<refentrytitle>textbgcolor</refentrytitle>
499
<refmiscinfo class="other" otherclass="datatype">color</refmiscinfo>
502
<refname>textbgcolor</refname>
503
<refpurpose>The background color of the table body</refpurpose>
507
<programlisting xml:id="textbgcolor.frag">
508
<xsl:param name="textbgcolor">white</xsl:param>
512
<refsection><info><title>Description</title></info>
513
<para>The background color of the table body.</para>
514
<para>Only applies with the tabular presentation is being used.</para>
519
<reference xml:id="toc">
520
<title>ToC Parameters</title>
521
<refentry version="5.0" xml:id="toc.blank.graphic">
523
<refentrytitle>toc.blank.graphic</refentrytitle>
524
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
527
<refname>toc.blank.graphic</refname>
528
<refpurpose>Use graphic for "blanks" in TOC?</refpurpose>
532
<programlisting xml:id="toc.blank.graphic.frag">
533
<xsl:param name="toc.blank.graphic" select="1"></xsl:param>
537
<refsection><info><title>Description</title></info>
538
<para>If non-zero, "blanks" in the the TOC will be accomplished
539
with the graphic identified by <varname>toc.spacer.image</varname>.
541
<para>Only applies with the tabular presentation is being used.</para>
545
<refentry version="5.0" xml:id="toc.blank.image">
547
<refentrytitle>toc.blank.image</refentrytitle>
548
<refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo>
551
<refname>toc.blank.image</refname>
552
<refpurpose>The image for "blanks" in the TOC</refpurpose>
556
<programlisting xml:id="toc.blank.image.frag">
557
<xsl:param name="toc.blank.image">graphics/blank.gif</xsl:param>
561
<refsection><info><title>Description</title></info>
562
<para>If <varname>toc.blank.graphic</varname> is non-zero, this image
563
will be used to for "blanks" in the TOC.</para>
564
<para>Only applies with the tabular presentation is being used.</para>
568
<refentry version="5.0" xml:id="toc.blank.text">
570
<refentrytitle>toc.blank.text</refentrytitle>
571
<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
574
<refname>toc.blank.text</refname>
575
<refpurpose>The text for "blanks" in the TOC</refpurpose>
579
<programlisting xml:id="toc.blank.text.frag">
580
<xsl:param name="toc.blank.text">   </xsl:param>
584
<refsection><info><title>Description</title></info>
585
<para>If <varname>toc.blank.graphic</varname> is zero, this text string
586
will be used for "blanks" in the TOC.</para>
587
<para>Only applies with the tabular presentation is being used.</para>
591
<refentry version="5.0" xml:id="toc.pointer.graphic">
593
<refentrytitle>toc.pointer.graphic</refentrytitle>
594
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
597
<refname>toc.pointer.graphic</refname>
598
<refpurpose>Use graphic for TOC pointer?</refpurpose>
602
<programlisting xml:id="toc.pointer.graphic.frag">
603
<xsl:param name="toc.pointer.graphic" select="1"></xsl:param>
607
<refsection><info><title>Description</title></info>
608
<para>If non-zero, the "pointer" in the TOC will be displayed
609
with the graphic identified by <varname>toc.pointer.image</varname>.
611
<para>Only applies with the tabular presentation is being used.</para>
615
<refentry version="5.0" xml:id="toc.pointer.image">
617
<refentrytitle>toc.pointer.image</refentrytitle>
618
<refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo>
621
<refname>toc.pointer.image</refname>
622
<refpurpose>The image for the "pointer" in the TOC</refpurpose>
626
<programlisting xml:id="toc.pointer.image.frag">
627
<xsl:param name="toc.pointer.image">graphics/arrow.gif</xsl:param>
631
<refsection><info><title>Description</title></info>
632
<para>If <varname>toc.pointer.graphic</varname> is non-zero, this image
633
will be used for the "pointer" in the TOC.</para>
634
<para>Only applies with the tabular presentation is being used.</para>
638
<refentry version="5.0" xml:id="toc.pointer.text">
640
<refentrytitle>toc.pointer.text</refentrytitle>
641
<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
644
<refname>toc.pointer.text</refname>
645
<refpurpose>The text for the "pointer" in the TOC</refpurpose>
649
<programlisting xml:id="toc.pointer.text.frag">
650
<xsl:param name="toc.pointer.text"> > </xsl:param>
654
<refsection><info><title>Description</title></info>
655
<para>If <varname>toc.pointer.graphic</varname> is zero, this text string
656
will be used to display the "pointer" in the TOC.</para>
657
<para>Only applies with the tabular presentation is being used.</para>
661
<refentry version="5.0" xml:id="toc.spacer.graphic">
663
<refentrytitle>toc.spacer.graphic</refentrytitle>
664
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
667
<refname>toc.spacer.graphic</refname>
668
<refpurpose>Use graphic for TOC spacer?</refpurpose>
672
<programlisting xml:id="toc.spacer.graphic.frag">
673
<xsl:param name="toc.spacer.graphic" select="1"></xsl:param>
677
<refsection><info><title>Description</title></info>
678
<para>If non-zero, the indentation in the TOC will be accomplished
679
with the graphic identified by <varname>toc.spacer.image</varname>.
681
<para>Only applies with the tabular presentation is being used.</para>
685
<refentry version="5.0" xml:id="toc.spacer.image">
687
<refentrytitle>toc.spacer.image</refentrytitle>
688
<refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo>
691
<refname>toc.spacer.image</refname>
692
<refpurpose>The image for spacing the TOC</refpurpose>
696
<programlisting xml:id="toc.spacer.image.frag">
697
<xsl:param name="toc.spacer.image">graphics/blank.gif</xsl:param>
701
<refsection><info><title>Description</title></info>
702
<para>If <varname>toc.spacer.graphic</varname> is non-zero, this image
703
will be used to indent the TOC.</para>
704
<para>Only applies with the tabular presentation is being used.</para>
708
<refentry version="5.0" xml:id="toc.spacer.text">
710
<refentrytitle>toc.spacer.text</refentrytitle>
711
<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
714
<refname>toc.spacer.text</refname>
715
<refpurpose>The text for spacing the TOC</refpurpose>
719
<programlisting xml:id="toc.spacer.text.frag">
720
<xsl:param name="toc.spacer.text">   </xsl:param>
724
<refsection><info><title>Description</title></info>
725
<para>If <varname>toc.spacer.graphic</varname> is zero, this text string
726
will be used to indent the TOC.</para>
727
<para>Only applies with the tabular presentation is being used.</para>
732
<appendix xml:id="stylesheet"><title>The Stylesheet</title>
734
<para>The <filename>param.xsl</filename> stylesheet is just a wrapper
735
around all these parameters.</para>
737
<programlisting xml:id="top">
739
<!-- This file is generated from param.xweb -->
741
<xsl:stylesheet exclude-result-prefixes="src" version="1.0">
743
<!-- ********************************************************************
744
$Id: param.xweb 7076 2007-07-18 16:20:33Z xmldoc $
745
********************************************************************
747
This file is part of the DocBook XSL Stylesheets distribution.
748
See ../README or http://docbook.sf.net/release/xsl/current/ for
749
copyright and other information.
751
******************************************************************** -->
753
<src:fragref linkend="autolayout-file.frag"></src:fragref>
754
<src:fragref linkend="header.hr.frag"></src:fragref>
755
<src:fragref linkend="footer.hr.frag"></src:fragref>
756
<src:fragref linkend="feedback.href.frag"></src:fragref>
757
<src:fragref linkend="feedback.with.ids.frag"></src:fragref>
758
<src:fragref linkend="feedback.link.text.frag"></src:fragref>
759
<src:fragref linkend="filename-prefix.frag"></src:fragref>
760
<src:fragref linkend="output-root.frag"></src:fragref>
761
<src:fragref linkend="dry-run.frag"></src:fragref>
762
<src:fragref linkend="rebuild-all.frag"></src:fragref>
763
<src:fragref linkend="nav.table.summary.frag"></src:fragref>
764
<src:fragref linkend="navtocwidth.frag"></src:fragref>
765
<src:fragref linkend="navbodywidth.frag"></src:fragref>
766
<src:fragref linkend="textbgcolor.frag"></src:fragref>
767
<src:fragref linkend="navbgcolor.frag"></src:fragref>
768
<src:fragref linkend="toc.spacer.graphic.frag"></src:fragref>
769
<src:fragref linkend="toc.spacer.text.frag"></src:fragref>
770
<src:fragref linkend="toc.spacer.image.frag"></src:fragref>
771
<src:fragref linkend="toc.pointer.graphic.frag"></src:fragref>
772
<src:fragref linkend="toc.pointer.text.frag"></src:fragref>
773
<src:fragref linkend="toc.pointer.image.frag"></src:fragref>
774
<src:fragref linkend="toc.blank.graphic.frag"></src:fragref>
775
<src:fragref linkend="toc.blank.text.frag"></src:fragref>
776
<src:fragref linkend="toc.blank.image.frag"></src:fragref>
777
<src:fragref linkend="suppress.homepage.title.frag"></src:fragref>
778
<src:fragref linkend="body.attributes.frag"></src:fragref>
779
<src:fragref linkend="sequential.links.frag"></src:fragref>
780
<src:fragref linkend="currentpage.marker.frag"></src:fragref>
781
<src:fragref linkend="banner.before.navigation.frag"></src:fragref>
782
<src:fragref linkend="table.spacer.image.frag"></src:fragref>
784
</xsl:stylesheet>