TeX4ht: LaTeX and TeX for Hypertext

TeX4ht was created by Eitan Gurari at Ohio State University. Eitan died unexpectedly in June 2009; we dedicate future development to his memory.

The new TeX4ht home page is http://tug.org/tex4ht. Please see that page for current development information. Work towards a first release is underway, but will take time to complete. Please forgive broken links and other problems with this documentation in the meantime.

TeX4ht is a highly configurable TeX-based authoring system dedicated mainly to produce hypertext. It interacts with TeX-based applications through style files and postprocessors, leaving the processing of the source files to the native TeX compiler. Consequently, TeX4ht can handle the features of TeX-based systems in general, and of the LaTeX and AMS style files in particular.

Pre-tailored configurations are offered for different output formats, including (X)HTML, MathML, OpenDocument, and DocBook.

 Table of Contents  Using the System  Calling Commands  Configurations  Installation  Bug Reports  Resources  License  Acknowledgment  Index

trouble shooting | Q/A | common problems for MathML

Using the System

Typical LaTeX source files can be compiled into standard HTML and XML formats in a manner similar to the way they are compiled into print formats, namely, through variations of the command htlatex filename "options1" "option2" "options3" "options4"’. For instance,

htlatex  filename  # generate HTML 
xhlatex  filename  # generate XHTML 

For details, visit the calling commands section.

References

The main features of TeX4ht are described in:

Installation

To be installed, the system needs a port made up of native utilities of TeX4ht and of non-native utilities. The easiest way to establish an up to date port is to download an installed distribution of the system, and upgrade it with the files provided here.

Establishing ports from scratch for Unix and MS Windows require additional effort, mainly because of the need to set up non-native utilities. Alternative ports for these and other platforms can be tailored in a similar manner. The distribution assumes compilations through command lines but graphical user inferfaces may also be employed.

Philip A. Viton discusses in details issues of installing TeX4ht under MikTeX and Scientific Word/WorkPlace, but many of the topics apply also to other platforms. Steven Zeil offers improvements for the above settings.

The literate sources of TeX4ht are also available, but they are not needed for installing the system. The literate views are very far from being in a desirable state for a review by a public eye–they reflect their true nature as being privately used for developing and maintaining the available code. The views follow a basement mentality: throw in without much scrutiny any item of possible value at some point of time, and clean a corner when the need arises for working on a specific issue of the code. The leading lines in the files indicate how the files can be compiled.

trouble shooting| bug fixes

Bug Reports

The development of the TeX4ht system is to a large degree driven by users’ bug reports and requests. In most cases, when providing feedback, it is essential to include the following information.

Translations of source files are centered around logical structures. Formatting instructions receive only limited attention.

Resources

Languages: LaTeX/TeX, HTML, XML/XSLT, MathML, OpenDocument, DocBook, TEI, Style Sheets, Validators
Converters
into
HTML/XML:
Backward
Converters:
Converters
for other
formats:

License

TeX4ht is provided under the LaTeX Project Public License (LPPL).

Acknowledgment

Eitan gratefully acknowledges the suggestions, contributions, and bug reports offered by many people. In particular, thanks go to Carmen Fierro, Piotr Grabowski, Gertjan Klein, Sebastian Rahtz, and Philip Viton for extensive feedback and help at early stages of this project.

This work was partially sponsored by NSF grant IIS-0312487.

http://tug.org/tex4ht
September 12, 2010