Sphinx-Gallery#
A Sphinx extension that builds an HTML gallery of examples from any set of Python scripts.
Features#
🚀 Create example galleries automatically by running pure Python example scripts while capturing outputs + figures, rendering them into reST files built into your documentation by Sphinx:
📝 Embed reST in your example Python files, allowing you to interweave narrative-like content with code that generates plots in your documentation. Sphinx-Gallery also automatically generates a Jupyter Notebook for each your example page.
📋 Add mini-galleries for API documentation. Sphinx-Gallery can generate mini-galleries listing all examples that use a particular function/method/etc.
🔗 Add intersphinx links to your examples. Sphinx-Gallery can automatically add links to API documentation for functions/methods/classes that are used in your examples (for any Python module that uses intersphinx).
🗒️ Manage multiple galleries to create and embed galleries for several folders of examples.
Installation#
You can do a direct install via pip
by using:
$ pip install sphinx-gallery
Sphinx-Gallery will not manage its dependencies when installing, thus you are required to install them manually. Our minimal dependency is Sphinx >= 4.
Sphinx-Gallery has also support for scraping images from packages like
Matplotlib, Seaborn, and PyVista. For much of this functionality, you will need
pillow
. We also recommend installing system optipng
binaries to reduce
the file sizes of the generated PNG files.
How to cite#
If you would like to cite Sphinx-Gallery you can do so using our Zenodo deposit.