Splitting the guide

[Simon Ruderich]

On Sun, Feb 17, 2008 at 01:32:09AM +0100, Rainer Müller wrote:
> 
> 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.

Simon
-- 
+ privacy is necessary
+ using http://gnupg.org
+ public key id: 0x6115F804EFB33229
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 194 bytes
Desc: not available
Url : http://lists.macosforge.org/pipermail/macports-dev/attachments/20080305/5e933f07/attachment.bin