Message-ID: <4B2251F7.2020901@dunslane.net>
Date: Fri, 11 Dec 2009 09:06:47 -0500
From: Andrew Dunstan <andrew@dunslane.net>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
	rv:1.8.0.12) Gecko/20071019 Fedora/1.0.9-3.fc6 pango-text
	SeaMonkey/1.0.9
MIME-Version: 1.0
To: Richard Huxton <dev@archonet.com>
CC: Robert Haas <robertmhaas@gmail.com>,
	"David E. Wheeler" <david@kineticode.com>,
	Alvaro Herrera <alvherre@commandprompt.com>,
	Peter Eisentraut <peter_e@gmx.net>,
	pgsql-hackers@postgresql.org, Dimitri Fontaine <dfontaine@hi-media.com>
Subject: Re: navigation menu for documents
References: <4A5CE7EB.20809@pgexperts.com> <4A5D1464.4040202@archonet.com>	
	<200907151333.02260.peter_e@gmx.net> <4A607573.60904@archonet.com>	
	<20090929151548.GD6116@alvh.no-ip.org>
	<4AC22933.2030701@dunslane.net>	 <4AC22DE5.8060805@archonet.com>	
	<7E8F774C-0F55-4512-BC04-A38CA8358DBE@kineticode.com>	
	<4AC46468.7010307@archonet.com>	
	<F1CE8CDC-CA94-4D16-8C69-71678C76A73A@kineticode.com>
	<603c8f070910010748x5fc0622fk2989fd7913d87f03@mail.gmail.com>
	<4AE9DEF6.3010207@archonet.com>
In-Reply-To: <4AE9DEF6.3010207@archonet.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit


Richard Huxton wrote:
> Reworked jquery-based document menu is attached.
>
> Untar will produce bin/ and html/
> cd .../html
> cp /path/to/htmldocs/* .
> ../bin/add_js.pl *html
>
> The contents should be on almost all relevant pages, and:
> - tested on FF3.5, IE7, Opera 9.x
> - expanded if screen width > 800px, closed otherwise
> - contain all page-headings and sub-page headings
> - highlight the current page in the tree
> - provide tooltips for entries that are too wide for the panel
>
> Issues:
> - slow to reload on each page (can be fixed)
> - based on hacked-together perl (this is temporary)
> - layout is perhaps a bit cramped?
>
> This last one is tricky. I can space it better if I can assume as 1280px
> width screen. I can space it better if I have a menu that slides out and
>   covers the whole page. Having the menu items wrap onto a second or
> third line just didn't work. At least I couldn't find a way that made it
> clear where the separating line between items was without cluttering the
> whole menu horribly. Settled on not indenting too much, no word-wrap and
> tooltips.
>
> Comments/suggestions/rotten tomatoes?
>   

Richard,

First, many thanks for doing this.

I don't see any comments having been made. I guess either everyone has 
been busy or they all think it's just fine (or both) :-)

I think you are definitely on the right track. I will use this, 
committed or not. But I'd like to see it finished and committed. Can you 
fix the 'slow to reload' problem - that is a bit of a pain. I'm not so 
worried about the use of perl to add the script calls - you need perl to 
build the docs anyway.

It wasn't terribly cramped for me.

I'm not sure everyone will want this. Maybe we need to provide 
"with-js-menu" and "without-js-menu" makefile target variants for html.

cheers

andrew