executablebooks / sphinx-book-theme

A clean book theme for scientific explanations and documentation with Sphinx
https://sphinx-book-theme.readthedocs.io
BSD 3-Clause "New" or "Revised" License
439 stars 201 forks source link

MAINT: pin pydata sphinx theme and update regression tests #862

Closed agoose77 closed 3 weeks ago

agoose77 commented 3 weeks ago

Our upstream theme has moved to sphinx>=6.1. Given our limited maintenance resources, we should mirror this to avoid testing two sets of pydata-sphinx-theme versions.

myst-parser also introduces changes to the AST that add to our maintenance burden. Rather than splitting our regression tests to handle a matrix of sphinx and parser versions, I'm going to drop myst-parser usage except for in the smallest of places.

agoose77 commented 3 weeks ago

@choldgraf I'm pinging you to let you know that I'm removing most usages of myst-parser in our test suite, to avoid things breaking that have nothing to do with this theme.

We still use myst-parser via myst-nb.