Skip to main content

Tools to maintain a respository of Jupyter notebooks

Project description


nbpages provides a Python toolset for managing a github repository of Jupyter notebooks. The project was inspired by the tools included with the Python Data Science Handbook by Jake Vanderplas.


pip install nbpages

Initial Setup

This package assumes you have created a github repository containing one or more Jupyter notebooks (*.ipynb) in a subdirectory named notebooks. The initial setup is performed with the command

python nbpages --setup

This creates a directory named templates if needed with configuration data found in the .git subdirectory. If not already present, Jinja templates and notebook_header.jinja are created. These templates should be edited as required.

Normal Usage

Notebooks filenames are prefixed with wherenn refers to the chapter number or, if a letter, to an Appendix. mmrefers to the section number. Section00` the chapter title and any prefatory material.

To use, execute the command line

python nbpages

from the top level directory of the notebook repository. The command will add or amend headers and navigation bars in all notebooks, and create a table of contents and a keyword index accessible from and the navigation bars.


To help achieve a consistent style over a collection of notebooks, use the command

python nbpages --lint

to locate some forms of notebook 'lint'. A current list of additional features can be found

python nbpages --help

Table of Contents

Keyword Index

Chapter 1.0 Getting Started with nbcollection

Appendix A. Style Guide

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 nbpages, version 0.0.1.dev5
Filename, size File type Python version Upload date Hashes
Filename, size nbpages-0.0.1.dev5-py3.7.egg (16.8 kB) File type Egg Python version 3.7 Upload date Hashes View
Filename, size nbpages-0.0.1.dev5.tar.gz (6.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page