kgryte d5b62bb8c9 Fix command 5 years ago
..
binder d5b62bb8c9 Fix command 5 years ago
notebooks 37fc9b0211 Add demo notebook and setup binder 5 years ago
src c7cecf12e8 v1.0.0-rc.0 5 years ago
style c7cecf12e8 v1.0.0-rc.0 5 years ago
.dockerignore 37fc9b0211 Add demo notebook and setup binder 5 years ago
.gitignore 1673e368cc added some comments 6 years ago
.prettierignore d24e666ca6 Make the codebase prettier. 6 years ago
.prettierrc d24e666ca6 Make the codebase prettier. 6 years ago
LICENSE 3ea740cce3 Add license. 7 years ago
README.md 37fc9b0211 Add demo notebook and setup binder 5 years ago
package.json 437e184037 v1.0.1 5 years ago
toc.gif fefeeac473 Update demo gif. 6 years ago
tsconfig.json 10f74e8a11 Update for jlab 0.35 prerelease 6 years ago
tslint.json d8c17aa369 Add a bunch of copyrights. 6 years ago
yarn.lock e823e814a7 Merge pull request #95 from jupyterlab/dependabot/npm_and_yarn/lodash-4.17.14 5 years ago

README.md

jupyterlab-toc

Binder

A Table of Contents extension for JupyterLab. This auto-generates a table of contents in the left area when you have a notebook or markdown document open. The entries are clickable, and scroll the document to the heading in question.

Here is an animation showing the extension's use, with a notebook from the Python Data Science Handbook:

Table of Contents

Prerequisites

  • JupyterLab >=1.0

Installation

jupyter labextension install @jupyterlab/toc

Development

For a development install, do the following in the repository directory:

jlpm install
jlpm run build
jupyter labextension install .

You can then run JupyterLab in watch mode to automatically pick up changes to @jupyterlab/toc. Open a terminal in the @jupyterlab/toc repository directory and enter

jlpm run watch

Then launch JupyterLab using

jupyter lab --watch

This will automatically recompile @jupyterlab/toc upon changes, and JupyterLab will rebuild itself. You should then be able to refresh the page and see your changes.