Re: navigation menu for documents

OK, if you untar the attached in the docs dir there are a three separate
sets of changes in it. It all functions, but consider it a discussion
point rather than a patch. Presumably we'd need to discuss a patch over
on the docs mailing-list.

1. Fixed navigation
Copy STYLING/stylesheet.css over the existing one and you will have
static navigation links top and bottom of the page.

2. Titles on navigation links.
Run ./STYLING/title_links.pl and it should add title attributes to the
navigation links. This means hovering over the top links gives the title
of the page they will go to. Presumably we could do this directly from
the sgml source, and I think it's probably worthwhile.

With 1+2 I think there's an argument in favour of removing the bottom
navigation - it's only useful if you can't see the top links.

3. Javascript popup menu.
This uses jquery, but that's just for convenience during discussion. You
could rework this without it.
Copy STYLING/*.js and STYLING/menu.inc to the docs dir and then run
./STYLING/include_javascript.pl to include the popup script.
The central "chapter heading" section of the top navigation area should
now be a link that toggles the menu on/off.
The menu could be as simple/complex as you like - this is just what I
hacked together by parsing the TOC on index.html

I've tested it on Firefox, Opera, IE7 and Safari. Realistically, the
only real problem platforms will be IE6 and perhaps iphones.

--
Richard Huxton
Archonet Ltd