Skip to main content

Next generation slides from Jupyter Notebooks

Project description

# nbpresent

[![](]( [![](
)]( [![](](

> remix your [Jupyter Notebooks]( as interactive slideshows


## Using
After [installing](#install) (and potentially enabling) as appropriate for your environment, relaunch the Jupyter Notebook: in the main toolbar, you will get two new buttons that toggle the _Authoring_ and _Presenting_ modes.

## User Documentation and Community
When _Authoring_, you can click on the `(?)` icon to see a number of in-Notebook guided tours that show all the features, as well as see links to community pages:

- [mailing list](!forum/nbpresent) for general or long-term discussion and announcements
- [issues]( for technical issues, as well as feature requests
- [chat]( for quickly connecting with other users

## Related Projects
- [live_reveal/RISE](, the original inspiration for this work, based on [reveal.js](
- [RMarkdown]( presentations

## Publishing
When you are happy with your presentation, you can download the standalone HTML file from the _File -> Download as -> Presentation (.html)_ menu item.

## Install

> Note: installing directly off this repo won't work, as we don't ship the built JavaScript and CSS assets. See more about [developing](#develop) below.

### `pip`
pip install nbpresent
python -m nbpresent.install

Then either run
%reload_ext nbpresent

_every time you start the notebook_ or _enable_ the extension for every notebook launch:
python -m nbpresent.install --enable --user

> `nbpresent.install` accepts all of the same arguments as `jupyter nbextension install`.

### `conda`
conda install -c anaconda-nb-extensions nbpresent

This will enable `nbpresent` by default.

## Export
Stock `nbconvert` doesn't store quite enough information, so you'll need to do something like this:
nbpresent -i notebooks/README.ipynb -o README.html
The resulting file can be hosted and viewed (but not edited!) on any site.

If you have installed [nbbrowserpdf](, you can also export to pdf:
nbpresent -i notebooks/README.ipynb -f pdf -o README.pdf

You can also pass in and get back streams:
cmd_that_generates_ipynb | nbpresent -f pdf > README.pdf

Here's the whole doc:

!nbpresent --help

usage: nbpresent [-h] [-i IPYNB] [-o OUTFILE] [-f {html,pdf}]

Generate a static nbpresent presentation from a Jupyter Notebook

optional arguments:
-h, --help show this help message and exit
-i IPYNB, --ipynb IPYNB
Input file (otherwise read from stdin)
-o OUTFILE, --outfile OUTFILE
Output file (otherwise write to stdout)
-f {html,pdf}, --out-format {html,pdf}
Output format

## Develop
This assumes you have cloned this repository locally:
git clone
cd nbpresent

### Repo Architecture

The `nbpresent` nbextension is built from `./src` into `./nbpresent/static/nbresent` with:
- `less` for style
- `es6` (via `babel`) for javascript
- `browserify` for packaging

The `nbpresent` python module (server component) is stored in the `/nbpresent` folder

### Getting Started
You'll need conda installed, either from [Anaconda]( or [miniconda]( You can import a Python 3.5 development environment named `nbpresent` from `./environment.yml`.

conda update env
source activate nbpresent

We _still_ use `npm` for a lot of dependencies, so then run:
npm install
npm run build:all

### Ensure development asset loading
To ensure that you always get the right assets, install the nbextension with the `symlink`, `force` and `enable` options:
python -m nbpresent.install --overwrite --symlink --enable --user
You may also want to pass in `--prefix` instead of user.

### Chore Automation
| Task | Command |
| Build all of the front end assets with sourcemaps for development | `npm run build` |
| Rebuild on every save | `npm run watch` |
| Rebuild all of the front end assets, and optimize it | `npm run dist` |
| Run the CasperJS and `nose` tests | `npm run test` |
| Check code style | `npm run lint` |
| Build the conda package | `npm run pkg:conda` |
| Build and upload the pypi package | `npm run pkg:pypi` |
| Build the ESDoc and Sphinx documentation | `npm run docs` |

## Changelog

### 1.0.0
- [Theme editor](
- Much more consistent UI
- Mnay bug fixes and more testing

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nbpresent, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size nbpresent-1.0.0-py2.py3-none-any.whl (364.9 kB) File type Wheel Python version 3.5 Upload date Hashes View
Filename, size nbpresent-1.0.0.tar.gz (360.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page