Re: navigation menu for documents - Mailing list pgsql-hackers

From David E. Wheeler
Subject Re: navigation menu for documents
Date
Msg-id 7E8F774C-0F55-4512-BC04-A38CA8358DBE@kineticode.com
Whole thread Raw
In response to Re: navigation menu for documents  (Richard Huxton <dev@archonet.com>)
Responses Re: navigation menu for documents
List pgsql-hackers
On Sep 29, 2009, at 8:55 AM, Richard Huxton wrote:

> For the browser, does the following match what you're after, Andrew?
> - clicking chapter title opens the browser panel
> - panel stays open until you click close icon
> - panel contains collapsable tree of chapter/section headings
> Alternatively, could just auto-open the browser panel if javascript is
> enabled and window is wider than N pixels.

Why wouldn't the entire TOC be in a collapsed list?

> In addition we'll presumably want to meet:
> - no external js libraries (or do we care, if we just reference it  
> from
> google?)

Save yourself the hassle and just bundle jQuery. That's what I've done  
for Pod::Site (module that builds the Bricolage API browser).

> - navigation is optional, disabling js leaves docs as at present

As long as there's a way to get the nav back from a link on each doc  
page.

> - works on all reasonable browsers (anything not IE6)

+1 (IE6--)

> - works online and in downloaded docs (except Windows .chm of course)

That'd be nice, too.

Best,

David



pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: Using results from INSERT ... RETURNING
Next
From: Mark Mielke
Date:
Subject: Re: Rejecting weak passwords