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 dependencies are Sphinx >= 4 and Pillow, which we use for scaling images.
Sphinx-Gallery has also support for scraping images from packages like
Matplotlib, Seaborn, and PyVista. We 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.
Contribute#
Thank you for your interest! Please see our contributing guide to get started.