Hi!

Wow, to much in this thread to quote directly, but what do you think about
this:

* We dump all current Nav Widgets
* Instead, we make one "Expanding, Unified Nav Bar" (EUNB).
* We use position:fixed so the Navbar is visible even if you scroll down the
page. Please check out
http://domm.zsi.at/modperl-site-domm/style6/docs/devel/writing_tests/writing_tests.html
and scroll down a bit. You should get a frame-like effect (the left bar
doesnt move a bit), but without frames and without JavaScript (and thus the
"stuttering" typical to DHTML stuff)

The EUNB should work like this:

Example:
First, the main categories are displayed (like now)

If you click on somehting (Documentation), you see

##NavBar##
..
[EMAIL PROTECTED]
Documentation
  mod_perl Developer's guide
  mod_perl User's guide
  The 1.x mod_perl Giude
Products
..

i.e. the titles of what is now displayed in the TOC.
(Stas, is it posssible to get this titles without having to modify the
POD sources?)

##Content##
Tons of documents for you to learn from

* mod_perl Developer's guide  This guide is aimed for mod_perl core and 3rd
party modules developers 
* mod_perl User's guide  Put some abstract here
* The 1.x mod_perl Guide covering mod_perl version 1.x

i.e.: Drop the iritating headline "Table of Content" here, just show the links


Click on the Developers Guide and you'll get:
##NavBar##
..
[EMAIL PROTECTED]
Documentation
  mod_perl Developer's guide
    Porting Modules from mod_perl 1.x to 2.x
    Developing and Running tests with the Apache::Test Framework
    ..
  mod_perl User's guide
  The 1.x mod_perl Giude
Products
..

##Content##
This guide is aimed for mod_perl core and 3rd party modules developers

..Links to items

(again, drop the TOC line)

And when you finally get to the "real" content, 
show the NavBar as before, and /now/ leave the "Table of Content" in the page

Summary:
There are two types of pages:
Indeces and Pages

Indeces look like
Expanded          Title
NavBar            Abstract
                  Links to Pages (without the headline TOC)

Pages look like:
Expanded          Title
NavBar            TOC
                  Content

What you get with this is:
* remove the ambiguity the TOC has now 
  (one time it links to another page, one time to internal links)
* remove pages that have a "Table of Content" but no content
* move /all/ Nav Widgets used to acces different pages in one location
  (i.e. left NavBar, breadcrumb, prev/next)

One problem will be to fit the long page titles in the NavBar.
Possible solutions are to make the NavBar wider (easy), put some "short
title" in the doc sources (cumbersome), use some small but clear indention
scheme (I guess this must be a table)

Unfortuinatly, I can't get the new Doc-Set running, so I currently cannot
try this ideas out.

Maybe I'll do some fake pages...

-- 
 D_OMM      +---->  http://domm.zsi.at <-----+
 O_xyderkes |       neu:  Arbeitsplatz       |   
 M_echanen  | http://domm.zsi.at/d/d162.html |
 M_asteuei  +--------------------------------+


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to