--sgml
to db2x_xsltproc
.
(Formerly, we described a quite intricate hack here to convert
to SGML to XML while preserving the ISO entities. That hack
is actually what --sgml
does.)
I don't want to hear about bugs in obsolete tools (i.e. tools that are
not in the current release of docbook2X.) I'm sorry, but maintaining all
that is a lot of work that I don't have time for.
iconv
error when converting documents.
iconv
says.
You can look at the partial man or Texinfo output — the offending
Unicode character should be near the point that the output is
interrupted. Since you probably wanted that Unicode character
to be there, the way you want to fix this error is to add
a translation for that Unicode character to the utf8trans
character map.
Then use the --utf8trans-map
option to the Perl
docbook2X tools to use your custom character map.
Alternatively, if you want to close your eyes to the utterly broken
Unicode handling in groff and Texinfo, just use the
--encoding=utf-8
option.
Note that the UTF-8 output is unlikely to display correctly everywhere.
Also, if you look at native Info pages, you will see there is a certain
structure, that your DocBook document may not adhere to. There is
really no fix for this. It is possible, though, to give rendering
hints to the Texinfo stylesheet in your DocBook source, like this this
manual does. Unfortunately these are not yet documented in a prominent place.
If you use the Perl wrapper scripts provided with docbook2X,
you only need to “install” the XSLT processors (i.e. for Java, copying
the *.jar files to
/usr/local/share/java), and you don't
need to do anything else.
If your customizations can be generally useful, I would like to hear about it.
If you don't want to muck with XSLT, you can still tell me what sort of features you want. Maybe other users want them too.