Jupytelab 如何安装 labextension
0 背景
随着Jupyter Lab的推广,最近也是受到很多启发,于是想试一下使用Jupyter Lab,上手之后发现Jupyter Lab和Jupter Notebook的插件是分开安装的,所以需要重新安装插件包。安装过程很容易出岔子,所以留下这篇教程帮助大家,如果有疑问欢迎大家留言讨论。以下是作者的环境信息:
环境 | 信息 |
---|---|
系统 | Win10 |
软件 | Anaconda3 |
程序 | Jupyterlab 2.2.2 |
语言 | Python 3.7.4 |
命令提示符 | Anaconda Prompt |
本教程可解决对应的问题有:
-
插件不兼容:
ModuleNotFoundError: Module not found: Error: Can't resolve 'worker-loader' in 'E:\Anaconda3\share\jupyter\lab\staging\node_modules\pdfjs-dist'
-
无法(重新)构建:
Build Recommended JupyterLab build is suggested: @jupyterlab/latex needs to be included in build @jupyterlab/toc needs to be included in build
本文写于2020年7月31日,之后随着 Jupyter Lab 和 labextension 的更新迭代,这些问题可能就不会再有了哦。
此外关于 Build 时发生的问题,大家也可以参考一下这篇文章:Jupyter Lab 升级后 Build 失败
1 环境确认
1.1 首先确保Jupyter Notebook的版本高于4.3
(base) C:\Users\admin>jupyter notebook --version
6.0.1 ←---------这个就是版本
1.2 然后请确保自己使用较高版本的Jupyter Lab,因为某些插件需要高版本(≥2.0)的Jupyter Lab。
(base) C:\Users\admin>jupyter lab --version
2.2.2 ←---------这个就是版本
1.3 版本更新
如果发现版本较低则需要更新程序(用install
也可以直接更新)
conda update jupyternotebook
conda update jupyterlab
或者使用pip更新:
pip install --upgrade jupyternotebook
pip install --upgrade jupyterlab
2 安装相关库
2.1 安装 nodejs
conda install -c conda-forge nodejs
2.2 安装 yarn
使用 conda 或者 pip 安装 yarn (如果没有这一步,后面安装插件的时候很可能因为yarn库的问题报错!),原因是插件的安装过程中需要大量的运行yarn ,所以更新一下没毛病。
conda install yarn
pip install yarn
3 安装插件包
3.1 安装要点
如果此时你已经成功打开和激活了Extension Manager:
- 注意:请勿使用 Jupyter Lab 中的 Extension Manager 安装插件!
- 注意:请勿使用 Jupyter Lab 中的 Extension Manager 安装插件!
- 注意:请勿使用 Jupyter Lab 中的 Extension Manager 安装插件!
重要的事情很有必要说三遍,目前版本(2020年7月31日)的Jupyter Lab 的 Extension Manager 存在BUG,如果直接使用 Extension Manager 下载和安装很有可能出现 安装完成后,无法进行rebuild。(目前已知:latex)
3.2 安装心仪插件包
目前最安全的方法便是使用 Anaconda Prompt 手动进行安装,例如:
- jupyterlab-manager:
jupyter labextension install @jupyter-widgets/jupyterlab-manager
- toc(目录):
jupyter labextension install @jupyterlab/toc
- github:
jupyter labextension install @jupyterlab/github
- 很多插件的需求插件
fasta-extension:jupyter labextension install @jupyterlab/fasta-extension
geojson-extension:jupyter labextension install @jupyterlab/geojson-extension
katex-extension:jupyter labextension install @jupyterlab/katex-extension
mathjax3-extension:jupyter labextension install @jupyterlab/mathjax3-extension
vega2-extension:jupyter labextension install @jupyterlab/vega2-extension
vega3-extension:jupyter labextension install @jupyterlab/vega3-extension
3.3 如何找到安装包及其下载代码
既然不能直接下载,那么我们需要如何找到安装包呢?方法其实很简单
- 通过各种推荐找到自己的心仪的包的名字
什么?你说不知道怎么找?当然有很多文章会进行推荐啦!
15个好用到爆炸的Jupyter Lab插件
JupyterLab插件下载和使用
好用到无敌的n款Jupyter 插件,建议收藏
其次我推荐去看 Jupyter Notebook 内的 Nbextensions,里面有十分详细的各类插件介绍,有心仪的 notebook 的插件名也可以尝试。 - 找到名字之后去 Jupyter Lab 的 Extension Manager 搜索该插件的名字
- 点击进入插件的 Github 网址
- 在插件的 Github 下的 Readme 内找到插件对应下载代码
- 在 Anaconda Prompt中 输入相应代码,等待安装完成,启动\重启 Jupyter Lab。(如果插件不兼容,会在安装时显示,无法完成安装,就不会影响到Jupyter Lab的正常使用)
- 使用新插件在代码海里畅游吧 😛
参考资料:
Jupyterlab官方Github
Jupyterlab官方Extensions Docs
Release 2.0.0 broken - can’t resolve ‘worker-loader’ in ‘/opt/conda/share/jupyter/lab/staging/node_modules/pdfjs-dist’ #135
Fix pdfjs-dist/webpack causing errors with certain configs #11964
Cannot find module ‘worker-loader!./build/pdf.worker.js’ from ‘webpack.js’ #11925