Writing documentation with DocBook-XML 4.2 |  |
Writing documentation with DocBook-XML 4.2 | |
This document assumes that you have XEP, a commercial product from RenderX. DocBook can also be processed using an open-source product, FOP from Apache.
The Tech Computer Center no longer supports the locally customized DocBook installation that works with FOP, but it is still available. In the section above setting up your directory for DocBook, the “tarball” archive for setting your directory is in a different path:
/u/www/docs/tcc/doc/docbook42/tcc.tgz |
rather than the location given above.
The software is generally reliable, but has the following specific limitations and problems.
These features of XEP won't work in the FOP toolchain:
You can't use any of the common entities such as “ for left double-quote.
Graphics in PNG format are not supported.
User-defined entities will not work.
Sometimes a section or subsection title will appear at the bottom of a page, with the first line of the following paragraph at the top of the next page.
If you use a <table> or <informaltable> inside a <listitem> element (which in turn is part of a <itemizedlist> or <variablelist> construct), the Flow Object Processor (FOP) will loop endlessly.