[Xmlunit-general] Documentation Revisited

[Stefan B. <bo...@ap...>]

Hi all,

the past five or six weeks I've been swamped in real live and was too
tired to do any actual OSS work when I came home from work, sorry
about the delay.

Last night I gave Docbook a try, the result can be seen here
<http://stefan.samaflost.de/xmlunit/docbook/>.  The .dbx file is the
source, the Ant build file generates the HTML output.  PDF has been
generated by dblatex[1] and looks more than promising (and far better
than the FOP results I remember).  What you see there is the default
output of the XSL stylesheets and dblatex, both can be tweaked in
several ways.

Installing dblatex on a Linux/Unix/Mac box shouldn't pose any problems
and it even went smoothely on my (Cygwin powered) WinXP work notebook.

So far I've tried to stick with Simplified Docbook[2] since it covers
all that we need and will keep the learning curve acceptable.

I also looked into Open Office (I really did) but think we should
prefer (Simplified) Docbook.  The syntax is pretty easy, our users can
be supposed to be XML savvy and the output looks really well.

The next step will be moving the existing document from PDF to docbook
which will be a boring manual task ...

Stefan

Footnotes: 
[1]  http://dblatex.sourceforge.net/

[2]  http://www.docbook.org/xml/simple/