Splitting the guide

[Rainer Müller]

simon at ruderich.com wrote:
>> 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

I like this one with the links. It makes it easy to get the URL which 
links exactly to this section. Good work!

>> 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.

Thanks a lot, I think this is a real good improvement for the guide.

markd at macports.org wrote:
> I don't understand.  The TOC entries are all linkable, and the TOC entries
> correspond to the titles.  What is it that is missing?

If I want to link to a specific section, it is not easy to find out 
which anchor it has. By making the headlines links, you can just click 
on them and copy the URL from the browser.

Rainer