Re: version 6.8 forces Table of Contents to top of HTML document

[Patrice Dumas]

On Tue, Dec 21, 2021 at 09:28:45PM +0000, Gavin Smith wrote:
> On Mon, Oct 18, 2021 at 10:35:17AM +0200, Benno Schulenberg wrote:
> > > By default a list of chapters isn't output at the start, as it would
> > > be repetition from the table of contents.  However, if 
> > > "-c CONTENTS_OUTPUT_LOCATION=inline" is given as an option to texi2any,
> > > I see that it is a problem that there is no initial list of chapters.
> > 
> > Indeed.
> 
> I've changed this in commit d94128ef20.  Now a list of chapters will be output
> with -c CONTENTS_OUTPUT_LOCATION=inline.

I think that it is wrong.  Indeed, the principle of
CONTENTS_OUTPUT_LOCATION=inline is to have the table of contents
output where the @-command @contents is.  If the user uses
CONTENTS_OUTPUT_LOCATION=inline it means that she wants the table of
contents to appear where @contents here, not at the beginning as it is
the meaning of CONTENTS_OUTPUT_LOCATION=after_top.

To me, if anything needs to change, it should only be the documentation.


> > Also, using those options and an @contents command, the menu is flush 
> > against the
> > left margin.  But without the options and without @contents, the menu is 
> > slightly
> > indented.  The latter looks much better.
> > 
> > 
> > > You could add @shortcontents at the start of the document to get a list
> > > of chapters.  Do you think that would solve the problem?
> > 
> > It would.  However, the links don't work: clicking them does not lead 
> > anywhere.
> > 
> > :|
> 
> Haven't looked into this yet.
> 
> > (Also, I don't want the loud "Short Table of Contents" header.  Is there a 
> > way
> > to suppress that?  I like that the list is numbered instead of bulleted, 
> > but do
> > not want the header.)

Removing completly the header can be done with the init file I attach.
Changing the formatting  would be more complicated, it would probably
require setting up a new 'format_...' like
format_contents_inline_element, and redefining it.

-- 
Pat

set_special_elements_heading.pm
Description: Text Data