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 xalandocu.xsl template, included in the $INODIR directory, incorporates the cascading style sheet docu.css, which is also in the $INODIR directory.

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

The background color is set 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 using the background color set.

Customizing the Character Formats for the Title Page and Headers

Context

In the docu.css file, you can customize

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

in terms of 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.