Classical Versus CoCalc Jupyter Notebooks¶
These enhanced features are available in CoCalc Jupyter notebooks:
If you are having trouble with the CoCalc Jupyter Notebook, you can switch to the Classical Jupyter Notebook. You can always switch back to CoCalc Jupyter easily later (and please let us know what is missing so we can add it!).
NOTE: The Classical Jupyter notebook is not supported in the Firefox browser. See Jupyter Server options below if you need to use Firefox and do not want to use the CoCalc Jupyter notebook.
You can change the default for opening a Jupyter notebook - CoCalc or Classical - by clicking the checkbox labeled “Jupyter classic …” in your Editor settings in Account Preferences.
To switch your notebook to Classical from within a CoCalc Jupyter notebook: select “File” → “Switch to Classical Notebook” in the menu.
To switch your notebook to CoCalc from within a Classical Jupyter notebook: select “File” → “Switch to Classical Notebook” in the menu.
- The main reasons to use the classical notebook are:
- need for certain extensions (Howto setup Jupyter Extensions).
- interactive widget support Note: as of April, 2019, CoCalc Jupyter notebooks support ipywidgets.
See our list of Jupyter related issues for more details.
Collaboration with Classical Jupyter¶
Here’s a pro tip if you need a classical Jupyter notebook for one of the reasons above and want real-time collaboration as well. If you and another user both select “Jupyter classic” in Account / Preferences / Editor, then open the ipynb file in cocalc as you normally would, multiple users are supported.
Multiple users are NOT supported with the Plain Jupyter Classic Server and JupyterLab Server activated under Project settings. Multiple users ARE supported with classical Jupyter embedded as a normal editor within CoCalc, which is what you get when you enable “Jupyter classic” as in the preceding paragraph.
Basically, we fully implemented two very different approaches to realtime collaboration for Jupyter.
Don’t mix CoCalc and Classical!¶
Multiple people simultaneously editing the same notebook, with some using classical and some using the new mode, will NOT work! Switching back and forth will cause problems (you may need to use TimeTravel to recover). Please avoid using classical notebook mode if you possibly can!
Alternatives: Plain Jupyter Server and JupyterLab Server¶
Using either of these options for the classical notebook has an advantage: it does not affect your “Jupyter classic” Editor setting, allowing you to keep CoCalc Jupyter notebook as the default for opening .ipynb files in the CoCalc main interface.
Note that the same warning applies as above: you shouldn’t open the same ipynb file in cocalc and in classical/lab servers.