Converting to Texinfo

DocBook documents are converted to Texinfo in two steps:

  1. The DocBook source is converted by a XSLT stylesheet into an intermediate XML format, Texi-XML.

    Texi-XML is simpler than DocBook and closer to the Texinfo format; it is intended to make the stylesheets’ job easier.

    The stylesheet for this purpose is in xslt/texi/docbook.xsl. For portability, it should always be referred to by the following URI:

    Run this stylesheet with db2x_xsltproc.

    Customizing.  You can also customize the output by creating your own XSLT stylesheet — changing parameters or adding new templates — and importing xslt/texi/docbook.xsl.

  2. Texi-XML is converted to the actual Texinfo files by db2x_texixml.

The docbook2texi command does both steps automatically, but if any problems occur, you can see the errors more clearly if you do each step separately:

$ db2x_xsltproc -s texi mydoc.xml -o mydoc.txml
$ db2x_texixml mydoc.txml

Options to the conversion stylesheet are described in the Texinfo stylesheets reference.