Re: [boost] [Boost-docs] Internal linkage with quickbook/boostbook

From: Stefan Seefeld (seefeld_at_[hidden])
Date: 2007-03-26 11:12:52

John Maddock wrote:
> Darren Garvey wrote:
>> I've noticed that internal links in the docs I've been building
>> default to the form: ....
>> I'm curious as to
>> why they don't omit 'page_name.html': I can't see the requirement for
>> that
>> in the HTML specs (I haven't read XSTL/XML/etc yet) and think most
>> browsers handle links properly when they're of the form: <a
>> href="#anchor_name">...</a>.
>>
>> Any comments?

I'm not sure either, but I can imagine this to be for situations
where in fact it does matter (because the generated html is chunked, say).

> Do we have any control over that or is it handled by the DocBook XSL 
> stylesheets?  I suspect the latter?

Yes, and yes. (Read: that's not an exclusive OR.)

The docbook XSL is meant to be customized, so as soon as you know
the template that generates the link you can tune it in a custom
(wrapper) stylesheet.

HTH,
                Stefan

-- 
      ...ich hab' noch einen Koffer in Berlin...