[Boost-docs] Internal linkage with quickbook/boostbook
I've noticed that internal links in the docs I've been building default to the form: <a href="page_name.html#anchor_name">...</a>. 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? Darren NB. This makes a difference when accessing www.example.com and ''index.html' is fetched implicitly: internal links then appear different to the browser, requiring another fetch.
Darren Garvey wrote:
I've noticed that internal links in the docs I've been building default to the form: <a href="page_name.html#anchor_name">...</a>. 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?
Do we have any control over that or is it handled by the DocBook XSL stylesheets? I suspect the latter? John.
John Maddock wrote:
Darren Garvey wrote:
I've noticed that internal links in the docs I've been building default to the form: <a href="page_name.html#anchor_name">...</a>. 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...
participants (3)
-
Darren Garvey -
John Maddock -
Stefan Seefeld