Re: [HIG] Mini-Guidelines style

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


  _____________________________                            ____
  rtnl     c z robertson ndirect co uk
                                                   icq 13294163

Attachment: pgpwd5XKrp0ZW.pgp
Description: PGP signature

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]