[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: control over sectioning and splitting
From: |
Per Bothner |
Subject: |
Re: control over sectioning and splitting |
Date: |
Sun, 10 Oct 2021 08:56:35 -0700 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.1.0 |
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
per@bothner.com http://per.bothner.com/