Skip to content

Commit 9642fa0

Browse files
author
Jürgen Hasch
committed
[skip ci] Add note about loading large notebooks
1 parent 86050e8 commit 9642fa0

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

docs/source/troubleshooting.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,22 @@ If you are migrating from an older version of the contrib notebook extensions
55
repository, some old files might be left on your system. This can lead, for
66
example, to having all the nbextensions listed twice on the configurator page.
77

8+
Extensions Not Loading for Large Notebooks
9+
-----------------------------------------
10+
If you have a large notebook, extensions can stop working after the notebook is loaded.
11+
Unfortunately, although this can be caused by nbextensions which take a long time to load,
12+
it's also an issue with notebook itself. You can check [#2075](https://github.com/jupyter/notebook/issues/2075)
13+
for details.
14+
15+
To mitigate this issue, you can increase the timeout for requirejs by adding it in your custom.js:
16+
17+
// default is 30s, increase to 1 minute
18+
window.requirejs.config({waitseconds: 60});
19+
20+
You can find details of where to find/create a custom.js file at the notebook documentation
21+
about [custom.js](http://jupyter-notebook.readthedocs.io/en/latest/examples/Notebook/JavaScript%20Notebook%20Extensions.html#custom.js).
22+
23+
More details about the issue on the nbextensions side can be found in [#1095](https://github.com/ipython-contrib/jupyter_contrib_nbextensions/issues/1195).
824

925
Removing Double Entries
1026
-----------------------

0 commit comments

Comments
 (0)