Converting between ipython notebooks and sphinx docs
Project description
What it does
nb2plots currently only converts IPython notebooks to ReST files for Sphinx.
Use with:
nb2plots notebook.ipynb > with_plots.rst
This converts the IPython notebook to Restructured text using the normal nbconvert machinery, with the additional feature that code cells get converted to a custom nbplot plot directives based on the matplotlib plot directive.
Specifically, a notebook code cell like this:
a = 1
becomes (in the ReST document):
.. nbplot:: >>> a = 1
This allows you to make the output ReST file testable using the Sphinx doctest builder, and the plots can be generated at Sphinx page build time.
In order to make this nbplot directive work for your sphinx builds, you should add the following to your conf.py file:
extensions = ["nb2plots.nbplots"]
The nbplot directive is very similar to the plot directive of matplotlib, and started life as a fork of that code. It differs mainly in that its default is to keep the name-space from one nbplot directive to the next in a given page, and has output defaults adapted to directive contents with source code rather than pointing to a standalone script. See the docstring of nb2plots/nbplots.py for details.
Dependencies
You will need Pandoc installed and available as the pandoc command.
For OSX, we recommend homebrew for installing Pandoc:
brew install pandoc
Code
See https://github.com/matthew-brett/nb2plots
Released under the BSD two-clause license - see the file LICENSE in the source distribution.
travis-ci kindly tests the code automatically under Python versions 2.6 through 2.7, and 3.2 through 3.5.
The latest released version is at https://pypi.python.org/pypi/nb2plots
Support
Please put up issues on the nb2plots issue tracker.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file nb2plots-0.4.zip
.
File metadata
- Download URL: nb2plots-0.4.zip
- Upload date:
- Size: 60.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 886bba92f410476f4989ce6883a350e93a8e5806d3d9a675bd113cf6e4ffe99c |
|
MD5 | c6745fc6ce0d9d06efb7f87ee3cd7e6c |
|
BLAKE2b-256 | 23883d4bfcf5af3eaf1ae0989bfeae9337d8ad105c40417fcbb4d7423533169b |