Re: Regarding the new Table of Contents in the GUB docs

[Reinhold Kainhofer]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am Montag, 29. September 2008 schrieb Valentin Villenave:
> 2008/9/29 Mats Bengtsson <address@hidden>:
> > I haven't had the time to read all the discussions related to the new
> > web layout of the 2.11 documentation, but wonder if I'm the only one who
> > miss the possibility to view the full table of contents with all
> > subsections expanded.
>
> Hi Mats,
>
> I definitely agree with you! Wouldn't it be possible to have the
> *complete* detailed TOC, at least at
> http://kainhofer.com/~lilypond/Documentation/user/lilypond/ ?
>
> The tocframe div on the left is great the way it is, but we definitely
> do need to have a detailed TOC on the first page.

If you really all think that the start page already should contain the full 
TOC, although I'd rather not do that, we can easily change that in the .init 
file by simply setting
   $Texi2HTML::Config::INLINE_CONTENTS = 1;
Then, however, there is no separate Contents page generated, but the TOC is 
inserted only where @contents appears in the texinfo file...
All [Contents] links in the navigation bars will of course still work, but 
bring the user right to the TOC on the start page.

Personally, however, I have always been annoyed by the excessively long title 
page, so I was quite happy that texi2html only put a short TOC on the start 
page and provided a separate page for the full, page-long TOC.

BTW, I just realized that it is now much simpler to go to the full TOC than 
before, because the links are right there on every page, while with the 2.10 
docs you first had to go up several times until you got to the start page of 
the manual...

Cheers,
Reinhold
- -- 
- ------------------------------------------------------------------
Reinhold Kainhofer, Vienna University of Technology, Austria
email: address@hidden, http://reinhold.kainhofer.com/
 * Financial and Actuarial Mathematics, TU Wien, http://www.fam.tuwien.ac.at/
 * K Desktop Environment, http://www.kde.org, KOrganizer maintainer
 * Chorvereinigung "Jung-Wien", http://www.jung-wien.at/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFI4VgtTqjEwhXvPN0RAoKAAJ9HzD7fU06I2Wz6gz9eMvYqk6g2JgCeO6gR
XQcJRHnKnZV0c/iK02EcFn8=
=x2mW
-----END PGP SIGNATURE-----