Skip to content

Conversation

@Alex-Welsh
Copy link
Member

I've never liked the default Sphinx docs theme.

This PR switches to more modern look. I'm happy to try other themes as well. I just picked one that I liked.
There's a great gallery here: https://sphinx-themes.org/#themes

Credit goes to @jackhodgkiss for suggesting this a while ago

This is what the new theme looks like:
image

Light theme:
image

Old theme for comparison:
image

@technowhizz
Copy link
Contributor

wait, they had themes all this time?!? Yes 100% this looks much better

@seunghun1ee
Copy link
Member

This looks much nicer

@Alex-Welsh Alex-Welsh marked this pull request as ready for review November 12, 2025 11:36
@Alex-Welsh Alex-Welsh requested a review from a team as a code owner November 12, 2025 11:36
MoteHue
MoteHue previously approved these changes Nov 12, 2025
@Alex-Welsh
Copy link
Member Author

I've switched to sphinx-immaterial to match the Azimuth docs. Looks like this:
image
And dark mode:
image

@Alex-Welsh Alex-Welsh enabled auto-merge (rebase) November 12, 2025 12:55
@MoteHue
Copy link
Contributor

MoteHue commented Nov 12, 2025

recheck

@Alex-Welsh Alex-Welsh merged commit 313ff3e into stackhpc/2025.1 Nov 12, 2025
22 checks passed
@Alex-Welsh Alex-Welsh deleted the docs-theme branch November 12, 2025 18:06
@MoteHue
Copy link
Contributor

MoteHue commented Nov 13, 2025

Should we backport this?

@Alex-Welsh
Copy link
Member Author

Yeah, we probably should. It's a bit jarring going back through the old versions now

@Alex-Welsh
Copy link
Member Author

Maybe it would be a good idea to give different versions different colours, or different logos, to make it a bit more obvious which version you're using

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants