目录：
- 1.Jupyter 介绍
- 2.Jupyter安装
- 3.notedown插件安装
- 4.扩展包安装
- 5.运行Jupyter
- 6.在远端服务器上运行jupyter
1.Jupyter 介绍
Jupyter Notebook是一款开放源代码的Web应用程序，允许您创建和共享包含实时代码，方程式，可视化和叙述文本的文档。用途包括：数据清理和转换，数值模拟，统计建模，数据可视化，机器学习等等。
翻译自Jupyter官网
2.Jupyter安装
2.1检查你的python版本
一般在Linux上直接在命令行执行下面命令便可以可到python版本。
查看系统Python版本
在Windows,命令行输入同样命令进行检查。
2.2安装jupyter
如果你的系统是Python 3的版本，输入以下命令安装：
- python3 -m pip install --upgrade pip
- python3 -m pip install jupyter
如果你的系统是Python 2的版本，输入以下命令安装：
- python -m pip install --upgrade pip
- python -m pip install jupyter
3.notedown插件安装
markdown是一种文字编辑器，通过约定的符号快速写出自己需要的文档。
通过下面命令在jupyter 上安装markdown
- pip install https://github.com/mli/notedown/tarball/master
插件安装完成后，需要配置启动Jupyter是默认启动markdown插件，配置过程如下：
(1)生成配置文件
- jupyter notebook --generate-config
(2)修改配置文件
Windows系统下配置文件在：C:\Users\Administrator.jupyter\jupyter_notebook_config.py
Linux系统的配置文件在：~/.jupyter/jupyter_notebook_config.py
打开这个文件，并将下面的配置添加到文件的末尾。
- c.NotebookApp.contents_manager_class = 'notedown.NotedownContentsManager'
4.扩展包安装
Jupyter notebook extensions是一个为Jupyter notebook提供一系列扩展的库。安装它将极大提升编程效率。
安装
(1) 安装Python包
- pip install jupyter_contrib_nbextensions
(2)安装js脚本和css文件
- jupyter contrib nbextension install --user
安装完成后，启动jupyter notebook,会有Nbextensions这一选项，点击会出现如下图情况。
Nbextensions
推荐三个插件：
1.Collapsible Headings 代码过长时，使用这个来折叠代码，简直不能太爽
2.ExecuteTime 记录Shell的最后运行时间
3.ScrollDown 输出很长时，自动往下刷新
5.运行Jupyter
Linux/Windows系统均是在命令行中输入jupyter notebook来启动jupyter
6.在远端服务器上运行jupyter
通常将jupyter运行在服务器上，然后通过浏览器远程使用jupyter,一般而言，在服务器启动jupyter后，需要交jupyter运行端口映射到本地，然后本地才可以访问。
（1）服务器启动jupyter
登录进服务器后，到你想使用jupyter的目录下运行jupyter,运行方式参考第4步
（2）映射服务器端口到地址
服务器启动后，会在命令行告诉你，jupyter是在那个端口执行的。Linux/Mac映射比较简单，Windows目前知道使用Xshell进行映射。
Linux/Mac映射服务器端口
- ssh tom@172.xx.xx.xx -L 8888:localhost:8888
Windows映射服务器端口
在Xshell上连接到服务器，并已经启动jupyter后，下一步是设置端口映射，进入当前连接的属性界面，点击隧道，将服务器端口与本地端口填上去，确定即可。
Xshell映射远程端口
参考材料：
- Jupyter官方安装过程
- 深度学习第一课:MXNet/Gluon环境配置和安装(插件安装部分)
- jupyter_contrib_nbextensions
