Re: [PATCH v3 1/4] docs: allow selecting a Sphinx theme

[Mauro Carvalho Chehab]

Em Thu, 2 Dec 2021 12:24:53 +0100
Miguel Ojeda <miguel.ojeda.sandonis@xxxxxxxxx> escreveu:

> On Wed, Dec 1, 2021 at 6:59 PM Mauro Carvalho Chehab
> <mchehab+huawei@xxxxxxxxxx> wrote:
> >
> > Instead of having RTD as an almost mandatory theme, allow the
> > user to select other themes via a THEMES environment var.
> >
> > There's a catch, though: as the current theme override logic is
> > dependent of the RTD theme, we need to move the code which
> > adds the CSS overrides to be inside the RTD theme logic.  
> 
> Does Sphinx support leaving the selection of the theme to "runtime",
> i.e. to let users pick a theme from a few from a combobox (e.g.
> light/dark)?
> 
> I assume not, but asking just in case.

The RTD dark theme allows that. It basically places a <sun>/<moon>
icon. When such icon is clicked, it switches between light/dark.

Thanks,
Mauro