nbsphinx 0.9.7


pip install nbsphinx

  Latest version

Released: Mar 03, 2025


Meta
Author: Matthias Geier
Requires Python: >=3.6

Classifiers

Framework
  • Sphinx
  • Sphinx :: Extension
  • Jupyter

Intended Audience
  • Education
  • Science/Research

License
  • OSI Approved :: MIT License

Operating System
  • OS Independent

Programming Language
  • Python
  • Python :: 3

Topic
  • Documentation :: 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.

Quick Start:
  1. Install nbsphinx

  2. Edit your conf.py and add 'nbsphinx' to extensions.

  3. Edit your index.rst and add the names of your *.ipynb files to the toctree.

  4. Run Sphinx!

Online documentation (and example of use):

https://nbsphinx.readthedocs.io/

Source code repository (and issue tracker):

https://github.com/spatialaudio/nbsphinx/

License:

MIT โ€“ see the file LICENSE for details.

Wheel compatibility matrix

Platform Python 3
any

Files in release

Extras: None
Dependencies:
docutils (>=0.18.1)
jinja2
nbconvert (!=5.4,>=5.3)
traitlets (>=5)
nbformat
sphinx (<8.2,>=1.8)