From: Andrew Dunstan <andrew@dunslane.net>
To: Richard Huxton <dev@archonet.com>
Cc: Robert Haas <robertmhaas@gmail.com>
Cc: David E. Wheeler <david@kineticode.com>
Cc: Alvaro Herrera <alvherre@commandprompt.com>
Cc: Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-hackers@postgresql.org, Dimitri Fontaine <dfontaine@hi-media.com>
Subject: Re: navigation menu for documents
Date: Fri, 11 Dec 2009 09:06:47 -0500
Message-ID: <4B2251F7.2020901@dunslane.net> (raw)
In-Reply-To: <4AE9DEF6.3010207@archonet.com>
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>
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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-hackers@postgresql.org
Cc: andrew@dunslane.net, dev@archonet.com, robertmhaas@gmail.com, david@kineticode.com, alvherre@commandprompt.com, peter_e@gmx.net, dfontaine@hi-media.com
Subject: Re: navigation menu for documents
In-Reply-To: <4B2251F7.2020901@dunslane.net>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox