Guys,

Thanks for your links. After some analysis I came to this conclusion:

- Postgres uses DocBook which is exactly what I need (XML / SGML and
then various means of transformation to various formats, e.g. via
XSL). Unfortunately, I have a subjective feeling that I'll need a lot
of time to work myself into DocBook and how it works and how it can be
customised. It feels as if DocBook can do a lot more than what I
really need

- HelpNDoc has a very nice tool to manipulate the proprietary binary
document format (which is actually a SQLite database). The binary
format is not a good thing, when putting the document under version
control. The generated HTML is difficult to style, the VB / Pascal (?)
API is not well documented. It's probably not possible to translate
the documentation easily, either (which might be interesting in the
future). Besides, I would have to pay 139€ for a license, which I
don't want to pay :-)

So I'm going for a simplified DocBook-like solution where I
XSL-transform a simple XML document into HTML, and later on into a
PDF. I have lots of experience with that, so it'll take the least
effort and give me the best-looking solution. Relevant resources are
here:

https://github.com/lukaseder/jOOQ/tree/master/jOOQ-website/src/main/resources

Cheers
Lukas

Reply via email to