| Has anyone used DocBook...
I authored my book "Building Oracle XML Applications"
for O'Reilly using XML, Docbook, and the XMetal editor.
Since my experience at work was mostly with the "data"
side of XML, I decided that doing the whole book in
XML would be a good learning experience about the
"document" side of XML.
It's about an 800 page book, produced from about 2.2 megs
of Docbook-valid XML source. O'Reilly produced the draft
copy for technical review directly from my XML source using
a variation on Norm Walsh's stylesheets for Docbook.
(http://www.nwalsh.com), then later transformed my XML
source to PDF for the final rendering/printing using
I spent a while customizing XMetal to work well with the
parts of the Docbook DTD I used in my book, and if useful
to you would be happy to share the .CSS file that represents
these customizations. This makes XMetal look more WYSIWYG
when working with Docbook documents.
The power of authoring the book in XML paid back many
times over during the course of my work on it as I could
use XSLT stylesheets to render outlines of my work-in-progress,
to print out lists of figures which were not preceded by
proper in-text references to the figures, dump out the
list of all figures whose captions exceeded 60 characters
in length, and hundreds of other useful structured searches
and formats that make my life easier.
I also use Docbook for all my documents at work -- product
specs, release notes, etc. Drop me an email and I'll send
you an example of a release notes together with the XSLT
scripts that I use to produce the HTML from the Docbook.
Steve Muench, Lead XML Evangelist & Consulting Product Manager
BC4J & XSQL Servlet Development Teams, Oracle Rep to XSL WG
Author "Building Oracle XML Applications", O'Reilly