Skip to content

Update the Read the Docs build and the documentation theme - #264

Merged
stefankoegl merged 1 commit into
masterfrom
claude/update-readthedocs
Nov 11, 2026
Merged

stefankoegl merged 1 commit into
masterfrom
claude/update-readthedocs

Conversation

@stefankoegl

Copy link
Copy Markdown
Owner
  • .readthedocs.yaml: build on Ubuntu 24.04 (was 22.04) with Python 3.13 (was 3.11), the version CI builds the docs with.
  • doc/conf.py: html_theme = 'alabaster' instead of 'default'.

'default' is a legacy alias of Sphinx's classic theme. Read the Docs used to substitute its own theme for it, but no longer does, so the published docs fall back to classic. Alabaster is the theme Sphinx itself uses by default and needs no extra dependency. If you prefer the Read the Docs look, the alternative is sphinx_rtd_theme, which would have to be added to doc/requirements.txt.

Verification

sphinx-build -W --keep-going -b html passes locally with the new theme. The Read the Docs build itself could not be run from here; it will show up as a check on this PR if the project has PR builds enabled.


Generated by Claude Code

Build on Ubuntu 24.04 with Python 3.13, the version CI builds the docs
with. Replace the 'default' theme, a legacy alias of Sphinx's 'classic'
theme since Read the Docs no longer substitutes its own theme for it, by
alabaster, the theme Sphinx uses by default.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PewzpjVeke4LTQ7Q88nyu6
@coveralls

Copy link
Copy Markdown

Coverage Status

coverage: 100.0%. remained the same — claude/update-readthedocs into master

@stefankoegl
stefankoegl merged commit 2f1063d into master Nov 11, 2026
22 checks passed
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.

3 participants