Re: Navigation Links
- From: Ali Abdin <aliabdin aucegypt edu>
- To: Gregory Leblanc <GLeblanc cu-portland edu>
- Cc: gnome-doc-list gnome org
- Subject: Re: Navigation Links
- Date: Wed, 30 Aug 2000 22:28:25 +0300
* Gregory Leblanc (GLeblanc@cu-portland.edu) wrote at 22:23 on 30/08/00:
> > -----Original Message-----
> > From: Ali Abdin [mailto:firstname.lastname@example.org]
> > Sent: Wednesday, August 30, 2000 9:38 AM
> > To: email@example.com
> > Subject: Navigation Links
> > I've just finished writing a first cut at navigation links
> > (Next/Home/Prev)
> > There are some 'caveats' to this:
> > 2) There are some 'issues' with it. It works fine fromt he
> > table of contents,
> > but when you 'click' on a section of the table of contents it
> > will only show
> > up if it is a sect1 id.
> Is the SGML being rendered into multiple pages, or into a single page?
> If a single page, next/home/prev are either mostly useless, or quite
> If multiple pages, what is being used as the break between pages? If sect1
> is being used as the break, then next/prev should go to the next sect1. If
> sect3 is being used as the break, then next/prev should go to the next
> sect3, unless there is none, and then it should go to the next sect2, unless
> there is none, and then it should go to the next sect1. Clearly, the last
> section in the document should not have a next. The first section MIGHT
> have a previous, assuming that the TOC comes before the first section.
Well - we split on any sect id specified at the command line - so if you
specify a sect1 id on the command line it will show the entire sect1
(including all sect2's, sect3's, etc.) - if you specify a sect3 id on the
command line it will only show that sect3 id (and any sect4/sect5 id's
Well the first section does not have a 'Previous' link perhaps it should (but
it would be an identical link to 'Home').
> > I don't know this doesn't seem right. A possible fix is to
> > not make links in
> > the Table of Contents to sect2/sect3/sect4/sect5 tags (it is
> > still possible to
> > go to them (from the command line) but no links are generated
> > and newbies
> > won't be confused?
> I think that we should make the sections in the TOC links, this makes
> navigation using the TOC useful. If we remove those links, we might as well
> just give them printed copies of the documentation, a major piece of
> electronic functionality is missing.
I am not saying remove the _ALL_ the links - I am saying just have the sect1
items int he TOC be the links (currently we make sect2/sect3/sect4/sect5 stuff
also in the links).
The TOC is not the same as the jade TOC - maybe that is what is confusing.
Perhaps you need to look at the gnome-db2html2 TOC :)
] [Thread Prev