On Tue, Aug 14, 2001 at 11:27:54AM +0100, Calum Benson wrote: > colin z robertson wrote: > > > What do other people think? Are other people familiar with docbook? > > Well, I'm not, I wouldn't know it if I saw it... Ah, so that puts us at three people unfamiliar and one familiar with docbook. hmm. But as Maciej says, we need to have the final document in docbook. Basically docbook is fairly simple. If you're familiar with html or other sgml languages you should be able to pick it up pretty quickly. There are two tricky things about it: Firstly, the GDP have a set of guidelines about how to use all the nifty tags for describing elements of GUIs, and secondly, the tools for transforming from docbook to other formats are a pain. The way to deal with the first problem is to ignore it until you're more familiar with the language, then go over what you've written and add those tags in. Alternatively you can just let me look over your work and I'll try to point out where you should be using them. And again, the way to deal with the second problem is to ignore it. When I started working with docbook I didn't have the tools set up on my box. I just wrote docbook code and assumed that other people would be able to transform it as required. If, on the other hand, you do want to install the tools, feel free to ask me if you're having problems. colin _____________________________ ____ rtnl http://rational.cjb.net c z robertson ndirect co uk icq 13294163
Attachment:
pgpwd5XKrp0ZW.pgp
Description: PGP signature