Re: [PATCH v2] docs: rework footer with semantic markup and responsive layout
From: Jonathan Corbet
Date: Wed Mar 25 2026 - 15:30:27 EST
Rito Rhymes <rito@xxxxxxxxxxxxxx> writes:
> The current Alabaster footer uses a generic `div` container, is
> hidden entirely at the theme's small-screen breakpoint, and does
> not provide a responsive layout for narrower viewports.
>
> Rework the Alabaster footer to use semantic markup while
> preserving its existing content, including the copyright notice,
> theme attribution, and Page source link. Structure it with a
> responsive flexbox so those items remain visible and orderly on
> smaller screens.
>
> Scope the change to Alabaster so other supported themes remain
> unaffected.
>
> Signed-off-by: Rito Rhymes <rito@xxxxxxxxxxxxxx>
> Assisted-by: Codex:GPT-5.4
> ---
> v2: add Assisted-by attribution
>
> Documentation/conf.py | 6 ++++
> Documentation/sphinx-static/custom.css | 25 ++++++++++++++++
> Documentation/sphinx/templates/layout.html | 33 ++++++++++++++++++++++
> 3 files changed, 64 insertions(+)
> create mode 100644 Documentation/sphinx/templates/layout.html
So the footer disappears because there is an explicit display:none in
the Alabaster CSS. That is indeed a bit weird, I wonder why they would
do that. That said, why not just override the CSS rather than adding
all of this complexity?
Thanks,
jon