You can automatically sort your glossaries by setting a stylesheet parameter. Glossary sorting is particularly useful when translating a glossary, because translation in place usually puts entries out of alphabetical order. Rather than rearranging the entries in the source file, you can just specify the sort feature.
You can turn on glossary sorting by setting the stylesheet parameter
glossary.sort to 1 (default value is zero). Then each group of
glossentry elements is sorted alphabetically on the
glossterm element contained within each
glossentry. The sort feature works for regular glossaries as well as those generated from a glossary database. The glossary sort feature was added starting with version 1.73 of the stylesheets.
Entries are sorted within each
glossary container, whichever is the parent element. There is currently no provision for generating letter titles to divide letter groups. The templates in the
glossary.xsl stylesheet module would need to be customized to generate such groupings.
The sort sequence is determined by the current value of the
lang attribute (which defaults to
en if no
xml:lang attribute is present).
The sort attempts to fold together uppercase and lowercase, and accented and unaccented characters, for most Latin alphabet languages. It does that by using the gentext templates named
normalize.sort.output, which are defined in each of the locale files that are described in the section “Generated text”. The
normalize.sort.input text is a sequence of all the lowercase letters, and they are matched by the sequence of uppercase letters in
normalize.sort.output. These are used as arguments in the XSLT
translate() function, whose purpose is to substitute one character for another. Each glossary term is converted to uppercase for sorting purposes only, and presented in its original letter case. If the case folding for the language you are processing is not correct (leading to an incorrect sort order), then you can customize those gentext templates for each language.
|DocBook XSL: The Complete Guide - 4th Edition||PDF version available|
Copyright © 2002-2007 Sagehill Enterprises