Contents Up Previous Next

Hypertext features

LaTeX is inherently suitable for specifying hypertext documents since it encourages description of the logical structure of a document using section commands. Therefore, a LaTeX document is automatically a hypertext document, without any further editing.

For Windows Help, a single RTF file is generated with topics corresponding to sections. A top level contents page shows each chapter or top-level section, and each chapter or section ends with a list of further sections or subsections. Tex2RTF outputs help files that may be read linearly using the << and >> buttons.

Similarly, a single wxHelp XLP file is generated.

For HTML, a different file is generated for each section, since the XMOSAIC browser works best with a large number of small files. The files are named automatically based on the name of the output file, with the contents page filename being formed from the output filename with _contents appended to the name. If the truncateFilenames option is begin used, then the contents page is just the root name, with a .htm suffix. The conversion may result in the generation of several hundred files for a large LaTeX input file.

To specify explicit jumps around a hypertext file, the \helpref command is used. The first argument is the text to be displayed at the point of reference, which will be highlighted in a hypertext file to allow jumping to a reference. The second argument is the reference label (there should be a corresponding \label command in the file, following a section or figure).

To use extra Tex2RTF features in proper LaTeX, such as \helpref and the C++ and CLIPS class reference documentation features, include the style file texhelp.sty.