$Id: param.xweb,v 1.3 2005/06/28 12:33:37 xmldoc Exp $ Walsh Norman 2002-2005 Norman Walsh This is reference documentation for all user-configurable parameters in the DocBook XSL Website stylesheets (for generating output from DocBook Website documents). header.hr boolean header.hr Toggle <HR> after header If non-zero, an <HR> is generated at the bottom of each web page, before the footer. footer.hr boolean footer.hr Toggle <HR> before footer If non-zero, an <HR> is generated at the bottom of each web page, before the footer. feedback.href URI feedback.href HREF (URI) for feedback link The feedback.href value is used as the value for the href attribute on the feedback link. If feedback.href is empty, no feedback link is generated. feedback.with.ids boolean feedback.with.ids Toggle use of IDs in feedback If feedback.with.ids is non-zero, the ID of the current page will be added to the feedback link. This can be used, for example, if the feedback.href is a CGI script. feedback.link.text string feedback.link.text The text of the feedback link Feedback The contents of this variable is used as the text of the feedback link if feedback.href is not empty. If feedback.href is empty, no feedback link is generated. filename-prefix string filename-prefix Prefix added to all filenames To produce the text-only (that is, non-tabular) layout of a website simultaneously with the tabular layout, the filenames have to be distinguished. That's accomplished by adding the filename-prefix to the front of each filename. autolayout-file filename autolayout-file Identifies the autolayout.xml file When the source pages are spread over several directories, this parameter can be set (for example, from the command line of a batch-mode XSLT processor) to indicate the location of the autolayout.xml file. FIXME: for browser-based use, there needs to be a PI for this... output-root filename output-root Specifies the root directory of the website When using the XSLT processor to manage dependencies and construct the website, this parameter can be used to indicate the root directory where the resulting pages are placed. Only applies when XSLT-based chunking is being used. dry-run boolean dry-run Indicates that no files should be produced When using the XSLT processor to manage dependencies and construct the website, this parameter can be used to suppress the generation of new and updated files. Effectively, this allows you to see what the stylesheet would do, without actually making any changes. Only applies when XSLT-based chunking is being used. rebuild-all boolean rebuild-all Indicates that all files should be produced When using the XSLT processor to manage dependencies and construct the website, this parameter can be used to regenerate the whole website, updating even pages that don't appear to need to be updated. The dependency extension only looks at the source documents. So if you change something in the stylesheet, for example, that has a global effect, you can use this parameter to force the stylesheet to rebuild the whole website. Only applies when XSLT-based chunking is being used. nav.table.summary string nav.table.summary HTML Table summary attribute value for navigation tables Navigation The value of this parameter is used as the value of the table summary attribute for the navigation table. Only applies with the tabular presentation is being used. navtocwidth length navtocwidth Specifies the width of the navigation table TOC 220 The width, in pixels, of the navigation column. Only applies with the tabular presentation is being used. navbodywidth length navbodywidth Specifies the width of the navigation table body The width of the body column. Only applies with the tabular presentation is being used. textbgcolor color textbgcolor The background color of the table body white The background color of the table body. Only applies with the tabular presentation is being used. navbgcolor color navbgcolor The background color of the navigation TOC #4080FF The background color of the navigation TOC. Only applies with the tabular presentation is being used. toc.spacer.graphic boolean toc.spacer.graphic Use graphic for TOC spacer? If non-zero, the indentation in the TOC will be accomplished with the graphic identified by toc.spacer.image. Only applies with the tabular presentation is being used. toc.spacer.text string toc.spacer.text The text for spacing the TOC     If toc.spacer.graphic is zero, this text string will be used to indent the TOC. Only applies with the tabular presentation is being used. toc.spacer.image filename toc.spacer.image The image for spacing the TOC graphics/blank.gif If toc.spacer.graphic is non-zero, this image will be used to indent the TOC. Only applies with the tabular presentation is being used. toc.pointer.graphic boolean toc.pointer.graphic Use graphic for TOC pointer? If non-zero, the "pointer" in the TOC will be displayed with the graphic identified by toc.pointer.image. Only applies with the tabular presentation is being used. toc.pointer.text string toc.pointer.text The text for the "pointer" in the TOC  >  If toc.pointer.graphic is zero, this text string will be used to display the "pointer" in the TOC. Only applies with the tabular presentation is being used. toc.pointer.image filename toc.pointer.image The image for the "pointer" in the TOC graphics/arrow.gif If toc.pointer.graphic is non-zero, this image will be used for the "pointer" in the TOC. Only applies with the tabular presentation is being used. toc.blank.graphic boolean toc.blank.graphic Use graphic for "blanks" in TOC? If non-zero, "blanks" in the the TOC will be accomplished with the graphic identified by toc.spacer.image. Only applies with the tabular presentation is being used. toc.blank.text string toc.blank.text The text for "blanks" in the TOC     If toc.blank.graphic is zero, this text string will be used for "blanks" in the TOC. Only applies with the tabular presentation is being used. toc.blank.image filename toc.blank.image The image for "blanks" in the TOC graphics/blank.gif If toc.blank.graphic is non-zero, this image will be used to for "blanks" in the TOC. Only applies with the tabular presentation is being used. suppress.homepage.title boolean suppress.homepage.title Suppress title on homepage? FIXME:If non-zero, the title on the homepage is suppressed? body.attributes attribute set body.attributes DEPRECATED white black #0000FF #840084 #0000FF DEPRECATED sequential.links boolean sequential.links Make sequentional links? FIXME currentpage.marker string currentpage.marker The text symbol used to mark the current page FIXME banner.before.navigation boolean banner.before.navigation Put banner before navigation? FIXME table.spacer.image filename table.spacer.image Invisible pixel for tabular accessibility This is the 1x1 pixel, transparent pixel used for the table trick to increase the accessibility of the tabular website presentation. The param.xsl stylesheet is just a wrapper around all these parameters.