Boost logo

Boost :

From: David Abrahams (dave_at_[hidden])
Date: 2006-03-23 12:45:43


Joel de Guzman <joel_at_[hidden]> writes:

> David Abrahams wrote:
>
>> I don't have a big problem with self-linking for a heading that isn't
>> in the TOC.
>
> The only heading that's in the TOC in the MPL docs is
> the one at the top of the page.

That's only because of the particular relationship between heading
levels, which entries are in the TOC, and the way the pages get broken
down. Is that the only/right way to do it?

> For that, as Daryle noted,
> there's a simpler way to grab the URL: get it from the
> address bar.
>
> I don't care so much about that topmost heading. I care
> about the ones down under. It just so happens that with
> BoostBook, you can't really know in advance which headings
> will be a top-page heading. In BoostBook, the user has control
> over the chunking of the pages to html. You can, for example have
> it all dumped into one big html file or small, fine grained
> html files. So, QuickBook does not really have any knowledge
> if it's a top-page section or not, and change the behavior
> accordingly. XSLT has that knowledge, though, so the smarts
> can be moved there. However, I don't quite like having different
> behavior for top-headings and sub-headings. IMO, we should have
> one and only one behavior for all headings, else kill it
> altogether.
>
>> Maybe the only right way to resolve this in the end is to get Jonathan
>> Turkanis' menu control integrated with BoostBook.
>
> Maybe :) Or the one Vladimir pointed out.

Sure, but that doesn't help me with locating myself "in context" when
browsing.

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com

Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk