docbook.css.source
Prev | HTML | Next

## docbook.css.source

docbook.css.source — Name of the default CSS input file

## Synopsis

    <xsl:param name="docbook.css.source">docbook.css.xml</xsl:param>

## Description

The `docbook.css.source` parameter specifies the name of the file containing the default DocBook CSS styles. Those styles are necessary when the `make.clean.html` parameter is nonzero.

The file is a well-formed XML file that must consist of a single `style` root element that contains CSS styles as its text content. The default value of the parameter (and filename) is `docbook.css.xml`. The stylesheets ship with the default file. You can substitute your own and specify its path in this parameter.

If `docbook.css.source` is not blank, and `make.clean.html` is nonzero, then the stylesheet takes the following actions:

1. The stylesheet uses the XSLT `document()` function to open the file specified by the parameter and load it into a variable.

2. The stylesheet forms an output pathname consisting of the value of the `base.dir` parameter (if it is set) and the value of `docbook.css.source`, with the `.xml` suffix stripped off.

3. The stylesheet removes the `style` wrapper element and writes just the CSS text content to the output file.

4. The stylesheet adds a `link` element to the HTML `HEAD` element to reference the external CSS stylesheet. For example:

       <link rel="stylesheet" href="docbook.css" type="text/css">

   However, if the `docbook.css.link` parameter is set to zero, then no `link` is written for the default CSS file. That is useful if a custom CSS file will import the default CSS stylesheet to ensure proper cascading of styles.

If the `docbook.css.source` parameter is changed from its default `docbook.css.xml` to blank, then no default CSS is generated. Likewise if the `make.clean.html` parameter is set to zero, then no default CSS is generated. The `custom.css.source` parameter can be used instead to generate a complete custom CSS file.

You can use the `generate.css.header` parameter to instead write the CSS to each HTML `HEAD` element in a `style` tag instead of an external CSS file.

Prev | Up | Next
make.clean.html | Home | docbook.css.link