This PR switches our approach to rendering notebooks from one that embeds raw HTML rendered using nbconvert to an approach that converts the notebooks to real docutils nodes ensuring that links, anchors, sections and other cross-referencing is properly supported. This support is built on top of jupyter_sphinx via the myst_nb extension. As a side-effect this also means that:
Parsing of .md files is now enabled by default
Parsing of .ipynb files is now enabled by default (i.e. they do not have to be wrapped by the notebook directive)
This PR switches our approach to rendering notebooks from one that embeds raw HTML rendered using nbconvert to an approach that converts the notebooks to real docutils nodes ensuring that links, anchors, sections and other cross-referencing is properly supported. This support is built on top of
jupyter_sphinx
via themyst_nb
extension. As a side-effect this also means that:.md
files is now enabled by default.ipynb
files is now enabled by default (i.e. they do not have to be wrapped by thenotebook
directive)