carolinarias/sphinx-gallery

Sphinx extension for automatic generation of an example gallery

Sphinx-Gallery

A Sphinx extension that builds an HTML version of any Python script and puts it into an examples gallery.

Who uses Sphinx-Gallery

• Sphinx-Gallery
• Scikit-learn
• Nilearn
• MNE-python
• PyStruct
• GIMLi
• Nestle
• pyRiemann
• scikit-image
• Astropy
• SunPy
• PySurfer
• Matplotlib Examples and Tutorials
• PyTorch tutorials
• Cartopy

Installation

Install via pip

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 >= 1.5
• Matplotlib
• Pillow

Sphinx-Gallery has also support for packages like:

• Seaborn
• Mayavi

Install as a developer

You can get the latest development source from our Github repository. You need setuptools installed in your system to install Sphinx-Gallery.

You will also need to install the dependencies listed above and pytest

To install everything do:

$ git clone https://github.com/sphinx-gallery/sphinx-gallery
$ cd sphinx-gallery
$ pip install -r requirements.txt
$ pip install -e .

In addition, you will need the following dependencies to build the sphinx-gallery documentation:

• Scipy
• Seaborn