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
simon@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@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
On Thu, Mar 06, 2008 at 02:04:48PM +0100, Rainer Müller wrote:
simon@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!
[snip]
Rainer
Hi Rainer, sorry for the late reply. I'm glad you like it. I just [1] committed the change and now the guide makes it easy to link to subsections. Thanks for the suggestion. Simon [1]: http://trac.macports.org/projects/macports/changeset/35199 -- + privacy is necessary + using http://gnupg.org + public key id: 0x6115F804EFB33229
Simon Ruderich wrote:
Hi Rainer,
sorry for the late reply.
I'm glad you like it. I just [1] committed the change and now the guide makes it easy to link to subsections. Thanks for the suggestion.
Thanks for the implementation :) I really like it. Rainer
participants (3)
-
markd＠macports.org
-
Rainer Müller
-
Simon Ruderich