Re: [gobo-eiffel-develop] DocBook

[Eric B. <er...@go...>]

Andreas Leitner wrote:
> 
> I had a quick look into DocBook, and I think it is a good idea to use it.
> Here is a tutorial for anybody who is interested:
> http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro/docbook-intro.html

I didn't know about this URL. Personally I bought this book
from O'Reilly:

 
http://www.amazon.co.uk/exec/obidos/ASIN/1565925807/qid=990884726/sr=1-1/202-2240368-1643821

Here are other interesting links:

  http://www.DocBook.org/
  http://www.oasis-open.org/docbook/
  http://www.nwalsh.com/docbook/index.html

It has been a long time since I had look at DocBook, so I
would probably have to visit these Web sites again.

> On Linux you can use jade or openjade to convert DocBook into HTML/ps/dvi/...
> Dunno where the RPMS are, since I had it installed already.
> 
> A eXML implementation should be possible - and will probably be usefull as well,
> because we can extend it to pretty print Eiffel source code (the hooks are there).
> 
> For the beginning I think it is safe if we start writing (or converting) our docs into DocBook.
> We can use the standard tools (jade) to convert the xml to html. Later we can start a Eiffel DocBook tool
> (,that initially supports only the subset of the standard that we need).

Yes, it is indeed the advantage of using DocBook: there are
already plenty of tools supporting this standard. So we can
already use these tools while waiting for our own converter
with some Gobo-personalized output.

Note that DocBook supports SGML and XML as input formats. I think
we will all agree that we should choose XML rather than SGML.
Hopefully jade (or whatever) supports it.

-- 
Eric Bezault
mailto:er...@go...
http://www.gobosoft.com