Useful Sphinx extensions
========================

Here are a few extensions that we have found useful:


* "sphinx_gallery.gen_gallery" : `Builds a gallery of examples in HTML <https://sphinx-gallery.github.io/stable/index.html>`_
                                 Run Python scripts and capture output and figures.
* "nbsphinx" : `render Jupyter notebooks <https://nbsphinx.readthedocs.io/en/0.9.5/>`_
* "sphinx.ext.intersphinx" : `Cross-reference between different Read the Docs projects <https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html>`_
* "breathe" : `Render doxygen generated documentation <https://breathe.readthedocs.io/en/latest/>`_
* "sphinxcontrib.mermaid" : `Create mermaid diagrams <https://sphinxcontrib-mermaid-demo.readthedocs.io/en/latest/>`_
* "sphinx.ext.mathjax" : `Render LaTex formatted equations <https://www.sphinx-doc.org/en/master/usage/extensions/math.html#module-sphinx.ext.mathjax>`_
* "sphinx.ext.autodoc" : `Render Python API docstrings <https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html>`_
* "sphinx.ext.napoleon" : `Render NumPy and Google styled docstrings <https://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html>`_



See `more here <https://www.sphinx-doc.org/en/master/usage/extensions/index.html>`_