A Python package for generating a table of contents for Jupyter notebooks
Project description
Jupyter Notebook ToC
This is a simple extension to generate a table of contents for a Jupyter notebook.
Basic Usage
import jupyter_toc
jupyter_toc.build()
It will return something like this:
Table of Contents
- [Introduction](#introduction)
- [Subhead](##subhead)
- [Usage](#usage)
- [Development](#development)
Advanced Usage
You can pass arguments to customize the following:
title
- The title of the table of contents.depth
- The maximum depth of headings to include in the table of contents.make_hyperlinks
- Whether to make the table of contents entries hyperlinks.print_output
- Whether to print the ToC or just return it as a string.
Contributing
Feel free to open an issue or submit a pull request.
To publish a new version to PyPI:
pip install twine # if you don't have it already
python setup.py sdist bdist_wheel # build the package
twine upload dist/* # upload to PyPI
Development
Running Tests
The test suite can be run using Python's built-in unittest
framework.
Navigate to the tests
directory and run:
python -m unittest test_jupyter_toc.py
Or, if you're in the root directory:
python -m unittest tests/test_jupyter_toc.py
Authors
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
jupyter-toc-1.1.0.tar.gz
(3.4 kB
view hashes)
Built Distribution
Close
Hashes for jupyter_toc-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f393dc157c30aa05abfc1384d3cad3424142745a6065677f031d021763cacc9f |
|
MD5 | 7b49e48179c979482f9fa6f4d46dbb71 |
|
BLAKE2b-256 | cfa9ae4bfb2323c203804466480e34edff87e66e53f37a509beb90d2a23eb7f3 |