Customization to select light/dark/dual mode

[pavithraes]

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

Currently, I think by default furo adapts to OS (or browser) settings to display light/dark mode. I'll be nice if we can choose to render only light mode, or only dark mode, or both like the present default.

Describe the solution you'd like
A clear and concise description of what you want to happen.

Something like a setting in conf.py for the preferred action?

html_theme_options = {
    "theme-color": light/dark/dual,
}

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Stick with the current default. :)

[pradyunsg]

Sounds fair!

I'll note that I'd rather to make this configurable by the end-user; i.e. a part of the generated website and controlled by the user on a per-device-browser basis. That's more common and is usually what the users expect anyway.

[pradyunsg]

Any bright ideas for where to put the toggle on the screen, on each resolution/breakpoint?

[McSinyx]

on each resolution/breakpoint?

😄 looking at the timestamp it's plausible that this leaked form a pip's discussion?

BTW, if the site's author uses images with transparent background, only light or dark would work, so it'd be nice if perse can hint that the other mode is broken by hardcoding the working mode.

[pradyunsg]

BTW, if the site's author uses images with transparent background, only light or dark would work, so it'd be nice if perse can hint that the other mode is broken by hardcoding the working mode.

If you'd like to make additional requests, please do so in a new issue. :)

[pradyunsg]

In #44, the suggestion is to add it to the right sidebar.

Currently, Furo completely disables the right sidebar if there is no TOC to show, since that's... well, the only thing in the right sidebar, and an empty drawer is useless. :)

[stonecharioteer]

I was going to say right side bar a la Docker, but @pradyunsg made the point I was about to make. How about give it as an option? Below the logo icon or at the bottom of the left sidebar

[mlazag]

how about somewhere in the left sidebar (above or below the search box)? it's the kind of control that does not have to be visible when the left sidebar is not visible.

[AWhetter]

This rust guide floats theirs in a bar at the top but we could make this button float in the top left of the content rather than in a bar? https://doc.rust-lang.org/book/ch04-01-what-is-ownership.html

Another option is at the bottom of the page with the footer.

[pradyunsg]

The bar at the top only shows up on small resolutions, and is hidden on wider screens.

Aside from it not being clear where to position it in the top bar, I'm on board for that on small screens. Any thoughts on what to do on desktop resolutions?

[adamgayoso]

any update on this? I'd like to use Furo, but we display a lot of jupyter notebooks that don't look good with the dark theme.