Splitting the guide

[markd at macports.org]

>> But as we are talking about the guide, I might also bring up another
>> issue with the current presentation. I find it difficult to link to
>> specific headlines. Could the headlines made clickable with a link
>> target on themself? Or maybe some marker item on mouse-move like trac
>> does? At the moment I always look into the source to find out how the
>> anchor was named which is a little bit annoying. Consider this as a
>> nice-to-have issue ;-)
>>
>> I already looked into the generation scripts for this, but it seems to
>> use a xslt stylesheet provided completely by docbook, so I don't know if
>> I would have to file my request there...
>>
>> Rainer
>
>Hi Rainer,
>
>I just tried this using DocBook but it didn't work for me. So I used a
>simple
>sed replacement to get this working. I created two examples:
>http://ruderich.com/macports/guide-link.html
>http://ruderich.com/macports/guide-title.html
>The first one wraps the sections (h1-h9) in links so you can click on
>them to
>see the anchor. The second one adds a title attribute which should
>display the
>anchor when you mouse over it for some time.
>
>Please tell me which you like more and I will add it to the documentation
>Makefile to add it to the guide.

I don't understand.  The TOC entries are all linkable, and the TOC entries
correspond to the titles.  What is it that is missing?

Mark