On 10/10/21 07:10, Patrice Dumas wrote:
I am probably missions something, but isn't what you want obtained with
--split=chapter and using sectioning commands like @section,
@subsection?
The issue is that there are some topics (chapters) that are large enough
to want to split into multiple pages for various reasons: big pages are
more overwhelming; the chapter topic naturally devides into several
semi-independent sub-topics; there may be external links one would
prefer not to break.
So one could promote each sub-topic to its own chapter, but that loses the
organization and clutters up the sidebar. At least for something
intended as a "landing" page (home page) it is highly undesible to have
too many "starting topics" in the initial sidebar, since an over-busy home page
may drive people away.
The fundamental problem is that texinfo assumes page-splitting at a
particular level on the hierarchy, but that is too inflexible: It makes
for a non-optimal browsing expeience.
--
--Per Bothner
p...@bothner.com http://per.bothner.com/
