Customizing the Layout of XML/HTML Documentation to Suit Your Corporate Identity

Use the XSL style sheet to specify the layout and style of XML/HTML documentation that is used during the style sheet transformation.

Style Using Style Sheets

Basically, the XSL style sheet is used to specify the layout and style of XML/HTML documentation that is used during the style sheet transformation.

You can determine the XSL style sheet in the options for a documentation command.

In principle, you can program a completely customized XSL style sheet in order to implement your own concepts for the layout and functionality.

Among other style sheets, the template xalandocu.xsl, which is delivered in the directory $INODIR, incorporates the cascading style sheet docu.css, which is also located in the directory $INODIR.

Below, we explain how to modify these templates in order to make fairly small adjustments to the layout without getting involved in programming style sheets.

Specifying the Background Color of the Documentation

Context

Set the background color in the docu.css file.

How to proceed

Open the docu.css file in the $INODIR directory using an editor.
Change the RGB color value for the background from white (hexadecimal number #FFFFFF) to the desired RGB color value (as a hexadecimal number).
```
body {
    background color : #FFFFFF;
}
;
```
Save the file.

The XML/HTML documents based on the docu.css file are created with the set background color.

Customizing the Character Formats for the Title Page and Headers

Context

In the docu.css file, you can customize the following:

The title page (TitleTop, TitleCenter and TitleBottom)
The heading levels (H1 to H5 and heading6 to heading11)

You can adjust the font size, font family, font style and font color.

It is not possible to specify detailed formats for the main text and table of contents.

How to proceed

Open the docu.css file in the $INODIR directory using an editor.
Change the font size, font family, font style or font color for the title page text or heading level. The example below shows the settings for Text Center on the title page.
```
.TitleCenter {
    font size   : 28pt;
    font family : Frutiger,Helvetica,Arial;
    font weight : bold;
    color       : #C32A1F;
    text decoration: none;
}
```
Save the file.

The XML/HTML documents based on the docu.css file are created using the character formats set for the title page and headers.