Re: Using texi2html for the documentation

[Graham Percival]

On Sun, 16 Mar 2008 22:03:00 +0100
Reinhold Kainhofer <address@hidden> wrote:

> Am Sonntag, 16. M__rz 2008 schrieb John Mandereau:
> > After quickly looking at texi2html docs, it should be possible to
> > get any desired output by redefining the output function, e.g.
> > "Music Glossary, double sharp", which is much prettier than
> > "(music-glossary)double sharp".  
> 
> Yes, I suppose that should be possible. But if anything I'd prefer
> "double sharp (Music Glossary)".
> Anyway, I now found the way to remove the (lilypond-internals) etc. 
> altogether. Already fixed online

Hmm, that's a pity -- I honestly thought that "(Music Glossary)
double sharp" looked better.  I'm certainly willing to live
without it, though.

> > > I'm not certain we only want two levels... the ideal would be if
> > > users could click to expand/contract each tree.  Perhaps two
> > > levels would be good by default, but I'd like it if people could
> > > expand them to see three or four levels.
> 
> Yes. However, the problem I have with the full TOC present in the
> HTML file is the size of it.

Everybody hates frames so much that it's not worth doing it that
way?

> What I have in mind is something like the following: Show only the
> first two levels (i.e. 1. and 1.1, 1.2 etc) plus the path to the
> current page. If you are on page "1.2.3.3 Unmetered music", the TOC
> would then display:

This looks like a good compromise.

> In particular, I don't like the default order 
> [<][>]  [<<][UP][>>]   [Top]  [Contents]  [Index]  [ ? ]
> 
> How about using two lines with left/center/right-aligned  links?
> Something like:
> [<< Musical ...]   [Top][Contents][Index][?]   [Specialist ...... >>]
> [< Ambitus]                     [Up]                    [Special note
> heads >]
> 
> (And I like the idea to print them in a smaller font)

Great!  That would be fantastic.  I have some quibbles about the
middle block; IMO it would be good to have one or two items on the
bottom line.  I have no particular idea how to divide them up at
the moment, though.

Can we add arbitrary text to the [?] section?  it might be good to
insert the LM 1.6 About the documentation  text in there.  (at the
moment I'm just asking if this is possible, not making a real
feature request)

Cheers,
- Graham