Previous: , Up: Generic Translator texi2any   [Contents][Index]


20.9 texi2html: Ancestor of texi2any

Conceptually, the texi2html program is the parent of today’s texi2any program. texi2html was developed independently, originally by Lionel Cons in 1998; at the time, makeinfo could not generate HTML. Many other people contributed to texi2html over the years.

The present texi2any uses little of the actual code of texi2html, and has quite a different basic approach to the implementation (namely, parsing the Texinfo document into a tree), but still, there is a family resemblance.

By design, texi2any supports nearly all the features of texi2html in some way. However, we did not attempt to maintain strict compatibility, so no texi2html executable is installed by the Texinfo package. An approximation can be run with an invocation like this (available as util/texi2html in the Texinfo source):

texi2any --set-customization-variable TEXI2HTML=1 ...

but, to emphasize, this is not a drop-in replacement for the previous texi2html. Here are the biggest differences:

Aside from the last, we do not intend to reimplement these differences. Therefore, the route forward for authors is alter manuals and build processes as necessary to use the new features and methods of texi2any. The texi2html maintainers (one of whom is the principal author of texi2any) do not intend to make further releases.

Here is the table showing texi2html options and corresponding texi2any customization variables.

--toc-linksTOC_LINKS
--short-extSHORTEXTN
--prefixPREFIX
--short-refSHORT_REF
--idx-sumIDX_SUMMARY
--def-tableDEF_TABLE
--ignore-preamble-textIGNORE_PREAMBLE_TEXT
--html-xref-prefixEXTERNAL_DIR
--l2hL2H
--l2h-l2hL2H_L2H
--l2h-skipL2H_SKIP
--l2h-tmpL2H_TMP
--l2h-fileL2H_FILE
--l2h-cleanL2H_CLEAN
--use-nodesUSE_NODES
--monolithicMONOLITHIC
--top-fileTOP_FILE
--toc-fileTOC_FILE
--framesFRAMES
--menuSHOW_MENU
--debugDEBUG
--doctypeDOCTYPE
--frameset-doctypeFRAMESET_DOCTYPE
--testTEST

Finally, any texi2html users seeking more detailed information can check the draft file doc/texi2oldapi.texi in the Texinfo source repository. It consists mainly of very rough notes, but may still be useful to some.


Previous: , Up: Generic Translator texi2any   [Contents][Index]