Skip to content

fix math rendering in docs with Sphinx 9 - #1005

Merged
bsipocz merged 1 commit into
executablebooks:mainfrom
zingale:fix_math_align
Sep 28, 2026
Merged

bsipocz merged 1 commit into
executablebooks:mainfrom
zingale:fix_math_align

Conversation

@zingale

@zingale zingale commented Sep 26, 2026

Copy link
Copy Markdown
Contributor

from Sphinx 8 -> 9, we no longer can use \begin{align} in math, instead it is automatically inferred. This fixes broken math on the rtd docs.

from Sphinx 8 -> 9, we no longer can use \begin{align} in math,
instead it is automatically inferred.  This fixes broken math
on the rtd docs.
@zingale

zingale commented Sep 26, 2026

Copy link
Copy Markdown
Contributor Author

here's the RTD link showing the broken math:
https://sphinx-book-theme.readthedocs.io/en/stable/reference/special-theme-elements.html#mathematics

I tested this change locally by running sphinx-build myself and get:

image

@bsipocz bsipocz added bug Something isn't working dependencies Pull requests that update a dependency file labels Sep 28, 2026

@bsipocz bsipocz left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good, thank you!

@bsipocz
bsipocz merged commit 158e8e4 into executablebooks:main Sep 28, 2026
13 of 14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working dependencies Pull requests that update a dependency file documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants