Helmut Denk wrote:
docbook would probably be adequate. its very good for making a book-like, structured document.


Which is pretty much what we're doing.

if you have to maintain more distributed information
http://dita.xml.org is a better choice.

Possibly. I'll have to look at it a bit more. It looks terribly abstract, and I can't really figure out what it is or does. We're just writing a user guide here. That's it. I want something with a simple (enough) model that is a good semantic fit for how I think about the structure of a user guide. Docbook and latex do a pretty good job at this.

but both dita and docbook are in some way
old-fashioned ... xslt/fo is an over-complex
technology IMO.


Possibly. But that's the tool's problem. We don't have to deal with that stuff.

an approach that seems more modern to me is:

http://princexml.com/

which means xml/xhtml + css.


Which schema would we use in this case? Make one up? Use docbook's?

This tool could be useful for the source -> pdf transformation, but does it handle the source -> html transformation?

a fantastic tool for editing docbook, dita
and xhtml is:

http://www.oxygenxml.com

the grails-documentation may also be a candidate to look at.


Do you know what they are using there? I couldn't figure it out from the source.


Adam


---------------------------------------------------------------------
To unsubscribe from this list, please visit:

   http://xircles.codehaus.org/manage_email


Reply via email to