TEX2page

 Dorai Sitaram 
 Download Version 2003-06-05 
 (A copy is included in PLT Scheme

 [t2p.png] 



Making books is a skilled trade,
like making clocks.

-- Jean de la Bruyère

TeX2page makes Web pages from TeX [23] manuscripts. It reads an input document that is marked up in a TeX format (viz, plain TeX, LaTeX [25], Texinfo [12]), and produces an output document with the functionally equivalent HTML markup. TeX2page uses the same input file syntax, calling conventions, and error-recovery mechanisms as TeX, and thus demands no additional expertise of a user already familiar with TeX. TeX2page runs on modern Schemes and Common Lisp.

There are several advantages to keeping the document source in TeX and leaving the task of converting to HTML to TeX2page: There is no need to write and maintain two separate documents, one for paper and the other for the screen. Indeed, there is no need to learn a new input format, as TeX2page reuses a format already in wide and stable use for printed documents [8364]. Creating TeX source requires no special-purpose software; any text editor will do. Furthermore, powerful and reliable tools such as BibTeX [32], MakeIndex [24], and MetaPost [18] have developed around TeX, and their benefits can be enjoyed by TeX2page too.

Finally, TeX, unlike HTML, is a programming language, which lets the composer of the document exercise a fine control over its structure and presentation. A converter such as TeX2page that can convert TeX macro definitions in addition to basic TeX markup enables the format converted to to also benefit from TeX's extensibility. For the cases where TeX2page's implementation of the TeX macro system is not manipulable enough, the document writer can use the TeX2page extension language, which is full Scheme augmented with all the TeX2page procedure definitions.

The rest of this manual is organized as follows:

    1  Running TeX2page
    2  TeX and TeX2page commands
    3  Sections
    4  Color and style
    5  Verbatim text
    6  Cross-references
    7  Images
    8  Paper and screen
    9  Scheme as TeX's extension language
    10  Recovery from errors
    A  Auxiliary files
    B  Bibliography
    C  Concept index
    D  Downloading and installing TeX2page

Last modified: Sunday, June 1st, 2003
HTML conversion by TeX2page 2003-06-05