Re: [PATCH v3 0/6] docs: Improvements to our HTML output

From: Bagas Sanjaya
Date: Sat Oct 15 2022 - 08:41:53 EST


On 10/14/22 00:29, Jonathan Corbet wrote:
> Sphinx has a theming mechanism for HTML rendering. Since the kernel's
> adoption of Sphinx, we have been using the "Read The Docs" theme — a choice
> made in a bit of a hurry to have *something* while figuring out the rest.
> RTD is OK, but it is not hugely attractive, requires the installation of an
> extra package, and does not observe all of the Sphinx configuration
> parameters. Among other things, that makes it hard to put reasonable
> contents into the left column in the HTML output.
>
> The Alabaster theme is the default for Sphinx installations, and is bundled
> with Sphinx itself. It has (IMO) nicer output and gives us the control
> that we need.
>

I don't see how switching theme will solve the left column problem. Are
there any customizations on that column that are planned?

--
An old man doll... just what I always wanted! - Clara