On Monday 05 July 2004 2:07 pm, Reece Dunn wrote:
> David Abrahams wrote:
> >Well it seems to me that the TOC on the front page should list only
> >the individual libraries and show no detail of their documentation
> >structure.
>
> Sure. This can be done by generating only part and chapter sections in the
> main ToC.
Setting toc.max.depth to 2 does this; try updating and then regenerating.
> An example is provided in toc-demo.html, but I don't know how portable it
> is. One issue with this approach is that it makes the chapter contents
> hidden on default (no good for browsers not supporting scripts). This means
> either (1) having the contents expanded by default; or (2) having a
> collapse-all function invoked when the document is loaded.
It doesn't help everyone, but in Mozilla I can turn on the "Site Navigation
Bar" to navigate through the docs with a nice little menu...
> >It might be worth trying for one release, to
> >see how it goes over. It would also eliminate at least one excuse
> >that certain library maintainers use for not improving their
> >documentation ;->
>
> It should be easy to make the BoostBook XSLT highly flexible in ToC
> generation, like I have done for the Boost banner/nav links (see
> tools/boostbook/xsl/navbar.xsl for the parameter descriptions). That way
> you can optionally tell it to use scripts, frames, both or neither.
Make sure you've exhausted all of the possible tweaks we can do just via XSL
stylesheet parameters for the DocBook->HTML phase. Norman Walsh has thought
of lots of these problems already :)
Doug
-------------------------------------------------------
This SF.Net email sponsored by Black Hat Briefings & Training.
Attend Black Hat Briefings & Training, Las Vegas July 24-29 -
digital self defense, top technical experts, no vendor pitches,
unmatched networking opportunities. Visit www.blackhat.com
_______________________________________________
Boost-docs mailing list
[EMAIL PROTECTED]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
