Skip to content

Register the theme through its entry point, and rebuild - #528

Merged
jpmckinney merged 6 commits into
0.9from
theme-registration
Oct 9, 2026
Merged

jpmckinney merged 6 commits into
0.9from
theme-registration

Conversation

@jpmckinney

@jpmckinney jpmckinney commented Oct 9, 2026 •

Copy link
Copy Markdown
Member

TLDR: Build updates.


Rebuilds the live documentation against the current theme, without taking 0.9-dev's content changes.

Replaces #527, which merged the whole of 0.9-dev and so would also have shipped example.json: Fix logical error in lifecyle cost and Update changelog.md. These are the same six commits, cherry-picked with -x; the resulting tree differs from 0.9-dev only in those two files.

This is a merge of build changes, not a rebuild. 0.9 still sets html_theme_path, while the theme is tracked unpinned, so rebuilding 0.9 as it stands would find the theme by directory, skip its setup(), and emit neither theme.js nor switchers.js — a broken sidebar and no banner or switcher. build: Let the theme register itself, instead of setting its paths is what removes that.

What this carries:

  • the theme is found through its sphinx.html_themes entry point, so its scripts and message catalogs are registered
  • the settings the theme now provides are dropped, along with the favicon
  • standard_theme moves to an uncompiled theme-requirements.txt, so pip-compile stops resolving the branch to a commit
  • workflow_dispatch, so this branch can be rebuilt from the Actions tab without a commit

Rebuilding also replaces the switchers.js deployed on 2026-09-24, which predates the theme leaving out a version switcher that holds a single option. /infrastructure/latest/ currently shows a one-option version dropdown; after this it shows none. The Spanish pages also stop declaring lang="en".

🤖 Generated with Claude Code

pre-commit-ci Bot and others added 6 commits October 8, 2026 23:19
updates:
- [github.com/astral-sh/ruff-pre-commit: v0.15.20 → v0.16.10](astral-sh/ruff-pre-commit@v0.15.20...v0.16.10)
- [github.com/astral-sh/uv-pre-commit: 0.11.26 → 0.12.23](astral-sh/uv-pre-commit@0.11.26...0.12.23)
- [github.com/biomejs/pre-commit: v2.5.2 → v2.5.15](biomejs/pre-commit@v2.5.2...v2.5.15)

(cherry picked from commit a4b3880)
…rack the branch instead of a commit

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RmJqv44wXNcNkarFBjvyzT
(cherry picked from commit 5db7c25)
The theme registers itself and its message catalogs through the `sphinx.html_themes` entry point, so its catalogs
are found: `get_html_theme_path()` returns site-packages, where they were never installed, and every theme string
fell back to English.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UAeUtu5XGYmmSwtyjVU7gL
(cherry picked from commit deb7213)
standard_theme defaults analytics_id, copyright, license_name, license_url, versions_url and display_version, and
provides the favicon.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RmJqv44wXNcNkarFBjvyzT
(cherry picked from commit 623a556)
…a new theme

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UAeUtu5XGYmmSwtyjVU7gL
(cherry picked from commit 4671f8e)
@jpmckinney jpmckinney mentioned this pull request Oct 9, 2026
@jpmckinney
jpmckinney merged commit b82d748 into 0.9 Oct 9, 2026
11 checks passed
@jpmckinney
jpmckinney deleted the theme-registration branch October 9, 2026 03:30
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.

1 participant