Open
Description
The sphinx-book-theme
has a really nice feature that maps each page with executable code to a direct binder link. However, I think we want to stick with the pydata-sphinx-theme
to have thematic consistency with the main nx docs, and unfortunately the per-page launch feature doesn't quite work out of the box.
You can still access all the notebooks on binder, but it's annoying for two reasons:
- the user has to click through from the root of the repository to the notebook they want and
- The user has to right-click and select "open as notebook" on binder.
We definitely want the original behavior from the sphinx-book-theme
- I think there are two ways we could potentially get it back:
- Jinja templates + macros for URL remapping
- upstreaming the functionality from
sphinx-book-theme
either to the pydata theme, tomyst-nb
, or pulling it out as a separate sphinx extension. See Possibility of modularizing/upstreaming notebook launching feature? executablebooks/sphinx-book-theme#326
Metadata
Assignees
Labels
No labels
Activity