Skip to content

Conversation

@WardBrian
Copy link
Member

Submission Checklist

  • Run unit tests
  • Declare copyright holder and open-source license: see below

Summary

Updates Sphinx config to match theming on https://mc-stan.org/

light mode dark mode

Copyright and Licensing

Please list the copyright holder for the work you are submitting (this will be you or your assignee, such as a university or company):
Simons Foundation

By submitting this pull request, the copyright holder is agreeing to license the submitted work under the following licenses:

@cdc-mitzimorris
Copy link

nice!

@amas0
Copy link
Collaborator

amas0 commented Oct 27, 2025

Confirmed the docs build and look correct on my machine.

One very minor point: the docs on mc-stan.org will default to using a light theme, whereas I think this build defaults to using whatever is set up as your default theme on your personal system/browser (which is dark on mine).

Not sure if there's a desire to align that behavior, just wanted to point it out.

@WardBrian
Copy link
Member Author

Fair enough. It's fairly easy to control, depending on which we'd prefer to centralize around:

  • if we want to default to light mode, we can just set "default_mode": "light" in the conf.py here
  • if we want to use the system config, we can set respect-user-color-scheme: true in the quarto config of the mc-stan.org to get the same behavior over there

@WardBrian WardBrian merged commit 979476c into develop Oct 28, 2025
19 checks passed
@WardBrian WardBrian deleted the docs/mc-stan-theme branch October 28, 2025 18:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants