Re: Docbook notes (was: About the docs)

Hi Bram

> I don't know the essential difference between SGML docbook and XML
> docbook.  Can both be converted to nice HTML and PDF?

They're meant to be equivalent to write with. Docbook XML can be
processed with more tools, and the XML stylesheets are under more
active development as far as I can tell.

I'd recommend using the XML version.

> Are both
> documented properly?  I have been using the on-line version of the
> O'Reilly book: http://www.docbook.org/tdg/en/html/docbook.html .  It
> looks it can be used both for the SGML and XML version, but it's not
> very clear about this.

I also use that book, and I skipped Docbook SGML entirely. It is rather
technical, but no more than the Vim helpfiles :]

Here is a book about the XSL stylesheets in particular:
   DocBook XSL: The Complete Guide
   Bob Stayton
   http://www.sagehill.net/docbookxsl/
It has information about the transformation tools that may be used
with Docbook XML (eg. xsltproc, xalan, saxon; fop, passivetex).

Here's an extensive FAQ-style site:
   http://www.dpawson.co.uk/docbook/index.html

Both Bob Stayton and Dave Pawson are luminaries on the docbook
mailinglists.

> The less tools we need the better.

Always true .. XML is a good choice, since you probably need XML tools
anyway, and Python includes good XML support.

j



-------------------------------------------------------
This SF.Net email sponsored by: Free pre-built ASP.NET sites including
Data Reports, E-commerce, Portals, and Forums are available now.
Download today and enter to win an XBOX or Visual Studio .NET.
http://aspnet.click-url.com/go/psa00100003ave/direct;at.aspnet_072303_01/01