Table of Contents
The DocBook XSL stylesheets have some special features for glossaries. In addition to formatting
glossary elements and their
glossentrys, they let you form cross references from your text to glossary entries and create a separate glossary database.
These formatting options are available for both HTML and print output.
The title and start of a glossary is considered a glossary title page. It can be controlled by the same title page customization methods as other components, and described in Chapter 10, Title page customization.
acronym first, followed by the
glossterm in parentheses.
glossterm first, followed by the
acronym in parentheses.
Don't show the
acronym at all.
If your entry has both
acronym, then both will appear in the output.
In addition to the above features, the print stylesheet supports these additional formatting features.
You can format a glossary as a
list with the terms to the left of the indented definition paragraphs, or as
blocks with each term stacked above its unindented paragraph. By default, a glossary is formatted as a
list. If you want to change all of your glossaries to format as
blocks, set the
glossary.as.blocks stylesheet parameter to a nonzero value. If you are
glosslist instead of a
glossary element, then use the
glosslist.as.blocks parameter instead. You can also control how
an individual glossary is presented by using a processing instruction
inserted into that
element in your document. Here is an example:
<glossary><title>Glossary</title> <?dbfo glossary-presentation="blocks" ?> <glossentry> ...
You can set the value to
list to format one glossary as a list when the parameter formats the rest as blocks. For a
glosslist, the processing instruction name is
glosslist-presentation, and it takes the same values. In all cases, the processing instruction overrides the stylesheet parameter for an individual glossary.
If your glossary is formatted as a list, you can control the indent of the definition paragraphs to allow space for the terms. The
glossterm.width stylesheet parameter sets the indent for all
glosslist elements. Its default
2in. You can also set the indent width for an
individual glossary using a processing instruction, as in this
<glossary><title>Glossary</title> <?dbfo glossterm-width="3.5cm" ?> <glossentry> ...
For a glossary formatted as a list, you can also control the minimum size of the space separating the term from the paragraph. That value is controlled by the
glossterm.separation parameter, and its default value is
0.25in. There is no processing instruction for this
|DocBook XSL: The Complete Guide - 3rd Edition||PDF version available|
Copyright © 2002-2005 Sagehill Enterprises