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

From: Reece Dunn (msclrhd_at_[hidden])
Date: 2004-02-09 10:36:54

Zbynek Winkler wrote:
>I do not think it is a good idea to start with such a huge toc. Maybe a mix 
>of
>condensed version and/or synopsis and/or "how to use this document" would 
>be
>better.

If there is a consensus on this, I'll have a look into this, but can't 
promise anything!

>My personal preference
>is to add margins to the sides so the text does not run all the way from 
>one
>border of the window to the other.

Adding:
p
{
margin-left: 5%;
margin-right: 5%;
}
to boostbook.css will do this. What do other people think?

>And last (but not least) - the huge green
>navbar at the top. It totally does not fit in with the rest of the 
>document.
>IMHO a navbar to be at each page have to be nonintrusive (small, not much
>colors) and usefull (something that you really need at each page) and it
>should have at least similar design as the rest of the document.

I have been working on getting navlinks at the top (which will be available 
when they get checked in). There was a few comments about retaining some of 
the original look & feel, so I tried to keep the top as close to the 
original as I could.

Based on your comments and Volodya requesting better "standalone" support, I 
have restructured the header to better reflect the new look. I'll be posting 
the result later today; I want to have a go at sorting out some of the other 
stuff first (like empty ToC's).

>PS. Also the local tocs kind of stand in the way of reading. I like them 
>more
>out of the way (ie. on the right side where I've put them in my php version 
>of
>the manual).

If you reveal your secrets, I'll see if they can be added into the new L&F 
:).

>PS2. I can't help it, I find it to look too "computer generated" ;-) It is
>missing a human touch ;-) It looks like latex2html generated so it also 
>shares
>its drawbacks. For example the arbitrary nesting: looking at the
>http://zigzag.lvk.cs.msu.su/~ghost/Boost.Build.docs2/bbv2.tutorial.hierarchy.html
>I cannot tell where I am in the document except looking at the url or 
>jumping
>to the main toc (but that also does not help much). Maybe it should have 
>less
>separate files? Or maybe some top navbar that would highlight at least the
>chapter I am in? Maybe some "bread crumbs" navigation?

Maybe you are waiting for the new look navigation bar :). I have included a 
snapshot (navbar.jpg) so you can see the look I'm working on.

Regards,
Reece

_________________________________________________________________
Express yourself with cool new emoticons http://www.msn.co.uk/specials/myemo
 ------=_NextPart_000_73e5_43db_16ec Content-Type: image/pjpeg; name="navbar.jpg"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="navbar.jpg"

[Attachment content not displayed.] ------=_NextPart_000_73e5_43db_16ec--