Jupyter 开发环境搭建

Jupyter Notebook 是一款开放源代码的 Web 应用程序,允许您创建和共享包含实时代码,方程式,可视化和叙述文本的文档。用途包括:数据清理和转换,数值模拟,统计建模,数据可视化,机器学习等等。

翻译自 Jupyter 官网

1.Jupyter 安装

2.1 检查你的 python 版本
一般在 Linux 上直接在命令行执行下面命令便可以可到 python 版本。

enter description here

在 Windows, 命令行输入同样命令进行检查。

2.2 安装 jupyter

如果你的系统是 Python 3 的版本,输入以下命令安装:

1
2
 python3 -m pip install --upgrade pip
python3 -m pip install jupyter

如果你的系统是 Python 2 的版本,输入以下命令安装:

1
2
python -m pip install --upgrade pip
python -m pip install jupyter

2.notedown 插件安装

markdown 是一种文字编辑器,通过约定的符号快速写出自己需要的文档。
通过下面命令在 jupyter 上安装 markdown

1
pip install https://github.com/mli/notedown/tarball/master

插件安装完成后,需要配置启动 Jupyter 是默认启动 markdown 插件,配置过程如下:

(1) 生成配置文件

1
jupyter notebook --generate-config

(2) 修改配置文件
Windows 系统下配置文件在:C:\Users\Administrator.jupyter\jupyter_notebook_config.py
Linux 系统的配置文件在:~/.jupyter/jupyter_notebook_config.py

打开这个文件,并将下面的配置添加到文件的末尾。

1
c.NotebookApp.contents_manager_class = 'notedown.NotedownContentsManager'

3. 扩展包安装

Jupyter notebook extensions 是一个为 Jupyter notebook 提供一系列扩展的库。安装它将极大提升编程效率。

安装
(1) 安装 Python 包

1
pip install jupyter_contrib_nbextensions

(2) 安装 js 脚本和 css 文件

1
jupyter contrib nbextension install --user

安装完成后,启动 jupyter notebook, 会有 Nbextensions 这一选项,点击会出现如下图情况。

Nbextensions

推荐三个插件:

1.Collapsible Headings 代码过长时,使用这个来折叠代码,简直不能太爽
2.ExecuteTime 记录 Shell 的最后运行时间
3.ScrollDown 输出很长时,自动往下刷新

4. 运行 Jupyter

Linux/Windows 系统均是在命令行中输入 jupyter notebook 来启动 jupyter

5. 在远端服务器上运行 jupyter

通常将 jupyter 运行在服务器上,然后通过浏览器远程使用 jupyter, 一般而言,在服务器启动 jupyter 后,需要交 jupyter 运行端口映射到本地,然后本地才可以访问。

(1)服务器启动 jupyter
登录进服务器后,到你想使用 jupyter 的目录下运行 jupyter, 运行方式参考第4步

(2)映射服务器端口到地址
服务器启动后,会在命令行告诉你,jupyter 是在那个端口执行的。Linux/Mac 映射比较简单,Windows 目前知道使用 Xshell 进行映射。

Linux/Mac 映射服务器端口

1
ssh tom@172.xx.xx.xx -L 8888:localhost:8888

Windows 映射服务器端口
在 Xshell 上连接到服务器,并已经启动 jupyter 后,下一步是设置端口映射,进入当前连接的属性界面,点击隧道,将服务器端口与本地端口填上去,确定即可。

enter description here

参考材料: