[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

footer navigation headers

From: Per Bothner
Subject: footer navigation headers
Date: Sun, 14 Feb 2021 12:32:58 -0800
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.7.0

[Sorry to throw all this on you guys all at once, but I'm on a roll,
and it would be nice to fix as many annoyances before the next release
as we can.  Thanks for your help and patience!]

I have two related problems relating to navigation headers that
are not at the top of a page - i.e. "internal" and "at-end".
I'd like to remove the non-initial non-final headers.
Assuming --split=section, I'd like to remove all the headers
generated for @subsection and @subsubsection.  While I agree they
may have some value, I think the extra "clutter" makes them a net
negative, especially when we have the js-info sidebar for navigation.

We can do this with CSS:
    div.subsection div.header { display: none }

However, this has the downside that it also hides the end-of-page
navigation header, which I think is useful.

The problem is that the  end-of-page header is emitted inside the
final @subsection.  I think it should be emitted outside the
final @subsection.

A related problem is that the end-of-page header is relative to the
final @subsection (and duplicates that internal header at the start
of the @subsection).  In my opinion, the header should point to
the next/previous/up of the @section (or @chapter for a chapter
without sections).  This is more logical, I think, whether or not
the @subsecton navigation headers are displayed.

The attached patch is a kludgy proof-of-concept, and assumes
SECTION_FOOTER_BUTTONS=0.  I'm not sure what configuration options
make sense, and what should be the defaults, but combination of
the patch, plus setting SECTION_FOOTER_BUTTONS=0, plus the above CSS rule
seems to work for me.  I also think the result HTML output makes
a good default, and it makes it easy to use CSS to hide the internal headers,
depending on individual preference.
        --Per Bothner
per@bothner.com   http://per.bothner.com/

Attachment: footer-navigation1.patch
Description: Text Data

reply via email to

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