Troubleshooting¶
If you are migrating from an older version of the contrib notebook extensions repository, some old files might be left on your system. This can lead, for example, to having all the nbextensions listed twice on the configurator page.
Extensions Not Loading for Large Notebooks¶
If you have a large notebook, extensions can stop working after the notebook is loaded. Unfortunately, although this can be caused by nbextensions which take a long time to load, it’s also an issue with notebook itself. You can check #2075 for details.
To mitigate this issue, you can increase the timeout for requirejs by adding it in your custom.js:
// default is 30s, increase to 1 minute
window.requirejs.config({waitseconds: 60});
You can find details of where to find/create a custom.js file at the notebook documentation about custom.js.
More details about the issue on the nbextensions side can be found in #1195.
Removing Double Entries¶
The nbextensions from older versions will be located in the nbextensions
subdirectory in one of the data
directories that can be found using the
jupyter --paths
command. If you run your notebook server with the --debug
flag, you should
also be able to tell where the extra nbextensions are located from jupyter
server logs produced by the jupyter_nbextensions_configurator
serverextension:
jupyter notebook --debug
To remove the extensions, use
jupyter contrib nbextension uninstall --user
and possibly the system-wide ones as well:
jupyter contrib nbextension uninstall --system
(though that may need admin privileges to write to system-level jupyter dirs, not sure on windows).
If the above doesn’t work, the configurator serverextension should give warning logs about where duplicate files are found.
As a matter of interest, the possible install locations are, briefly:
- user’s jupyter data dir, on Windows ~.jupyter
- python sys.prefix jupyter data dir, in sys.prefix + /share/jupyter/nbextensions
- system-wide jupyter data dir, OS-dependent, but in Windows 7, I think they should be in ~\AppData\jupyter\nbextensions
To find all possible paths, you can use the jupyter command:
jupyter --paths
Generating Local Documentation¶
The documentation can be found online at readthedocs: https://jupyter-contrib-nbextensions.readthedocs.io/en/stable/
If you want to create documentation locally, use
$ tox -e docs
Display the documentation locally by navigating to build/html/index.html
in your browser. Or alternatively you may run a local server to display the docs.
In Python 3:
python -m http.server 8000
Then, in your browser, go to http://localhost:8000
.
If you want to avoid tox
(if you are using conda for example), you can call sphinx-build
directly:
sphinx-build -E -T -b readthedocs -c docs/source . docs/build
Then, start a local server
python -m http.server 8000
And go to ‘http://localhost:8000/build/docs/source/index.html’.