Screen OutputMoving information aroundSplitting your inputMaking an index or glossaryContentsIndex

Making an index or glossary

The Hyperlatex converter understands the \index command. It collects the entries specified, and you can include a sorted index using \htmlprintindex. This index takes the form of a menu with hyperlinks to the positions where the original \index commands where located.

You may want to specify a different sort key for an index intry. If you use the index processor makeindex, then this can be achieved in LaTeX by specifying \index{sortkey@entry}. This syntax is also understood by Hyperlatex. The entry

   \index{index@\verb+\index+}

will be sorted like "index", but typeset in the index as "\verb+\index+".

However, not everybody can use makeindex, and there are other index processors around. To cater for those other index processors, Hyperlatex defines a second index command \cindex, which takes an optional argument to specify the sort key. (You may also like this syntax better than the \index syntax, since it is more in line with the general LaTeX-syntax.) The above example would look as follows:

   \cindex[index]{\verb+\index+}

The hyperlatex.sty style defines \cindex such that the intended behavior is realized if you use the index processor makeindex. If you don't, you will have to consult your Local Guide and redefine \cindex appropriately. (That may be a bit tricky--ask your local TeX guru for help.)

The index in this manual was created using \cindex commands in the source file, the index processor makeindex and the following code (more or less):

   \W \section*{Index}
   \W \htmlprintindex
   \T \input{hyperlatex.ind}

You can generate a prettier index format more similar to the printed copy by using the makeidx package donated by Sebastian Erdmann. Include it using

   \W \usepackage{makeidx}

in the preamble.


July 13, 2005

Screen OutputMoving information aroundSplitting your inputMaking an index or glossaryContentsIndex