Tillsten / sphinx-gallery

Sphinx extension for automatic generation of an example gallery

Home Page:https://sphinx-gallery.github.io

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Sphinx-Gallery

image

image

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

A demo of a gallery generated by Sphinx-Gallery

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.8.3
  • 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.

Additional to the dependencies listed above you will need to install pytest and pytest-coverage for testing.

To install everything do:

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

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

  • Scipy
  • Seaborn

About

Sphinx extension for automatic generation of an example gallery

https://sphinx-gallery.github.io

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:Python 96.5%Language:Shell 1.6%Language:CSS 1.6%Language:Makefile 0.2%