[Top][All Lists]

[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,

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/

reply via email to

[Prev in Thread] Current Thread [Next in Thread]