Re: [jamboost] Re: V2 documentation format: a resolution?

From: Vladimir Prus (ghost_at_[hidden])
Date: 2004-02-03 08:53:11

Zbynek Winkler wrote:
> Vladimir Prus wrote:
> > So, let's go with DocBook?
>
> Is there anyone here familiar with the DocBook toolchain? What is needed to
> get i.e. html out of it? Could someone write a quick howto for the most
> common platforms, so we can try it out before the final decision?

First, you need to get XSLT tool called xsltproc from

http://xmlsoft.org/XSLT/

(Debian has it already, other Linux distros are likely to have it too).

Then, get example from

http://zigzag.cs.msu.su:7813/doc.zip

After unpacking, running "./run.sh" on Linux will create single-html version 
of docs and multiple-page version. On other platforms, you'd need to manually 
execute two commands in ./run.sh.

The results don't look extremely nice, but I guess that's because there's not 
CSS to help with this. I'm hoping Christopher knows how to make result 
nicer ;-)

Of course, in real life we'd be using Boost.Build to generate docs, since 
almost all the bits are already there.

- Volodya