From: | Andrew Dunstan <andrew(at)dunslane(dot)net> |
---|---|
To: | PostgreSQL WWW Mailing List <pgsql-www(at)postgresql(dot)org> |
Subject: | [Fwd: RFC - Navigation menu for documents] |
Date: | 2010-05-24 22:15:18 |
Message-ID: | 4BFAFA76.6080206@dunslane.net |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-www |
Has anyone looked at incorporating this in our online docs? It's really
quite nifty and makes the docs a lot more user-friendly IMNSHO.
cheers
andrew
-------- Original Message --------
Subject: RFC - Navigation menu for documents
Date: Fri, 19 Feb 2010 13:46:52 +0000
From: Richard Huxton <dev(at)archonet(dot)com>
To: pgsql-docs(at)postgresql(dot)org
CC: Andrew Dunstan <andrew(at)dunslane(dot)net>
Andrew Dunstan mentioned a folding table-of-contents facility for the
manuals some time ago. I've had a few minutes to tweak my last attempt
and I think it's time to decide what to do with it.
Objectives:
- Make it easier to navigate our (now very long) manual
- Make it easier to provide links on the mailing-lists (my bugbear)
- Not get in the way if not wanted
Features:
- Contents panel on LHS, can slide off screen if wanted
- Automatically slid off screen on narrow displays
- Nested tree controls
- Automatically opens tree to currently displayed page
- Search-box displayed on A-Z index page (below contents box)
I'm surprised at how much better this is than Ctrl+F
- Mailing-list links next to each heading
So you can right-click+copy the url to the "master" copy of the docs
Dependencies:
- local (writable) copy of the html docs
- Perl for installation
- wget for installation
- jquery (fetched using wget, MIT licence)
- Assumes developer (cvs) version of docs
See lines 115/6 of html/contents.js if you want to reference the 8.4 docs
Installation:
cd /dir/above/html/docs
tar -xzf pg_js_manual.tgz
./bin/INSTALL
Testing:
- Firefox 3.6
- Internet Explorer 7
- Safari (4?)
- Opera 9
- Sluggish on a phone, but fine on a 5-year old laptop
- Obvious optimisations done - not sure there's much more to be gained
Where do we go from here?
1. We can make use of some/all of this on the main site.
2. Add it as a contrib/ project
3. Put it on pgfoundry
I'll probably do #3 anyway in case someone else is interested in working
on it.
--
Richard Huxton
Archonet Ltd
Attachment | Content-Type | Size |
---|---|---|
pg_js_manual.tgz | application/x-compressed-tar | 6.2 KB |
From | Date | Subject | |
---|---|---|---|
Next Message | Andrew Dunstan | 2010-05-25 12:21:04 | Re: [Fwd: RFC - Navigation menu for documents] |
Previous Message | Matteo Beccati | 2010-05-23 16:33:34 | Re: Re: Mailing list archives (was Re: [HACKERS] mailing list archiver chewing patches) |