Re: [Savannah-dev] Savannah/CodeX documentation - Next steps?

[Jaime E. Villate]

Mon, Apr 29, 2002 at 05:47:59PM +0200

On Mon, Apr 29, 2002 at 05:47:59PM +0200, mathieu wrote:
> It seems to me that docbook can itself generate texinfo.

I don't think so. The DSSSL stylesheets for the SGML flavor of DocBook produce
ugly Jadetex, but not texinfo. Norman Walsh XSL stylesheets for the XML flavor
are very nice, but they do not produce any texinfo either. I know it should be
possible to write XSL stylesheets (combined with some scripting to deal with
TeX special characters) to generate texinfo, but I have not seen that done
yet.

I think that a document like the one Laurent describes would be extremely
useful for some audiences. And I agree with Loic that DocBook/XML is the best
candidate nowadays. After two years of intensive work with it, trying to
convince people to use it, I realize that most people still find DocBook hard
to use so I'm now moving into simple plain text files which will then be used
to generated DocBook automatically (and LaTeX) in a "wiki" fashion; you can
see what I'm doing at http://villate.org/parsewiki

For Laurent to convert his Word documents into DocBook could be a nightmare;
but if he saves a part of his document in a plain ASCII text version and sends
it to me, I can check how difficult it would be to make it into some decent
DocBook using parsewiki (the figures should be sent separately and indicated
where in the text they should go).

Cheers,
Jaime