Joel de Guzman <joel@boost-consulting.com> 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