Skip to content

Latest commit

 

History

History
38 lines (26 loc) · 1.11 KB

README.rst

File metadata and controls

38 lines (26 loc) · 1.11 KB

Jupyter Notebook Tools for Sphinx

nbsphinx is a Sphinx extension that provides a source parser for *.ipynb files. Custom Sphinx directives are used to show Jupyter Notebook code cells (and of course their results) in both HTML and LaTeX output. Un-evaluated notebooks -- i.e. notebooks without stored output cells -- will be automatically executed during the Sphinx build process.

Documentation (and example of use):

http://nbsphinx.rtfd.org/

Code:

http://github.com/spatialaudio/nbsphinx/

Python Package Index:

https://pypi.python.org/pypi/nbsphinx/

License:

MIT -- see the file LICENSE for details.

Quick Start:
  1. Install nbsphinx with pip:

    pip install nbsphinx --user
  2. Edit your conf.py and add 'nbsphinx' to extensions.
  3. Edit your index.rst and add the names of your *.ipynb files (without the .ipynb extension) to the toctree directive.
  4. Run Sphinx!