hg book

[Dongsheng Song]

On Sat, Jul 25, 2009 at 12:46 AM, Alexander
Poddey<alexander.poddey at gmx.net> wrote:
> Hallo,
>
> I wonder with which tool the hg book has been written.
> I checked the source code and find it interesting because it allows several
> targets (e.g. pdf, webpage). The text is held in xml format. I guess the
> author does not code those files directly.
>
> Does anyone know which software is used for that?
>

No, the source code is docbook xml format, edit by plain text editor or
docbook xml perceptived editor, e.g. vim, emacs, oxygen.

We can use docbook xsl and xslt tool translate xml to html or fo format,
then use fop/xep translate fo format to pdf.

> Background: I need to write a documentation for a code project. the code is
> based on numerical algorithms. I therefore do not only need to document the
> code, but also the ideas behind, reference some papers, possibly workout some
> equations. There will also be some tutorial or 'hands-on' chapters.
>
> As a theoretician, I most naturally, would use latex for such a thing. Plain
> latex however is somewhat problematic, because collegues of mine need to
> contribute and are not willing to learn latex....
>

NetBSD htdocs is another example, it written by docbook xml, use xslt for html
output, use dssl and openjade for dvi/ps/pdf output.

But I opposed use openjade for mbcs language, it's very difficult or impossible.

--
Dongsheng Song