Users Manual for tohtml: Producing True Hypertext Documents from LaTeX

William Gropp
Mathematics and Computer Science Division

Users Manual for tohtml:
Producing True Hypertext Documents from LaTeX
by
William Gropp

The World Wide Web has made it possible to use and disseminate documents as ``hypertext.'' One of the major advantages of hypertext over conventional text is that references to other documents or items can be linked directly into the document, allowing the easy retrieval of related information. A collection of documents can also be read this way, jumping from one document to another based on the interests of the reader. This does require that the hypertext documents be extensively cross-linked. Unfortunately, most existing documents are designed as linear documents. Even worse, most authors still think of documents as linear structures, to be read from front to back. To deal with this situation, a number of tools have been created that take documents in an existing word-processing system or markup language and generate ``HTML,'' the hypertext markup language used on the Web. While this process makes a single document available in a convenient form on the Web, it does not give access to cross-document linking, a major advantage of hypertext. This manual describes a program, tohtml, that takes LaTeX input files, as well as files of link information, and produces a hypertext document that can contain extensive cross-links. A related program, doctext, aids in the generation of manual pages that can be referenced by a LaTeX document.


Contents

  • Introduction
  • tohtml
  • Getting Started
  • Command Line Arguments
  • doctext
  • Building a Map File
  • Map Files for man Pages
  • Fine-Tuning
  • The anlhtext Style File
  • Adding Pointers to Other Pages to Every Page
  • Adding a disclaimer to the top of every page
  • Errors
  • User-defined Replacements
  • Examples
  • Single-Page Descriptions
  • Chosing LaTeX executable
  • Books
  • Comments, Bugs, and Suggestions