xarray-contrib / xarray-tutorial

Xarray Tutorials
https://tutorial.xarray.dev/
Apache License 2.0
166 stars 106 forks source link

Update to JupyterBook 1.0 #241

Closed scottyhq closed 2 weeks ago

scottyhq commented 4 months ago

May need to update link syntax in some notebooks https://github.com/executablebooks/jupyter-book/releases/tag/v1.0.0

scottyhq commented 1 month ago

Since we use conda-lock we require releases from pypi or conda-forge so are blocked by having a sphinx-exercise extension release https://github.com/executablebooks/sphinx-exercise/issues/69

The easiest solution might be to remove the extension and just use markdown dropdowns to reveal exercise solutions - see https://github.com/xarray-contrib/xarray-tutorial/issues/88. You loose automatic numbering

FWIW In the long run, development of jupyterbook 2.0 also seems to be moving away from depending on sphinx (and therefore sphinx extensions) https://executablebooks.org/en/latest/blog/2024-05-20-jupyter-book-myst/