Python-Jupyter Notebook使用技巧

更新

201908更新
Jupyter Notebook已經升級為Jupyter Lab，官方的介紹“JupyterLab is the next-generation web-based user interface for Project Jupyter”。於2019年7月發行1.0版本。
總的來說，Jupyter Lab功能更強大，支持多標簽，還支持Markdown編輯器。更像一個基於網頁版的IDE。有興趣的話可以嘗試。

0. 體驗與Windows下的安裝

0. 可選：可以通過Jupyter Notebook體驗這個鏈接體驗一下Jupyter Notebook。
1. 首先安裝Jupyter Notebook：pip install jupyter。建議使用國內的源，pip install jupyter -i https://mirrors.aliyun.com/pypi/simple/
   • 安裝時，請以管理員身份運行命令行提示符，然后再進行安裝。
   • 如要安裝Jupyter Lab，請使用pip install jupyterlab
2. Jupyter啟動方法：
   • 方法1：搜索jupyter-notebook.exe文件，右鍵點擊創建快捷方式到桌面。還可修改jupyter的啟動起始位置，見后文。、
   • 方法2：命令行下，進入想要創建Jupyter Notebook的目錄后，執行jupyter notebook。
     • 小技巧：Windows圖形界面下找到該目錄，然后shift+鼠標右擊目錄空白處，在彈出菜單點擊“在此處打開XXX窗口”。
3. 可選：安裝目錄插件為Jupyter的筆記添加目錄。如果安裝后找不到Nbextensions這個標簽，可以直接在瀏覽器中通過http://localhost:8888/nbextensions來訪問，從而啟用相關插件。
   Jupyter Notebook 添加目錄

參考資料：
Installing Jupyter

啟動碰到的問題

1.啟動jupyter notebook出錯，顯示“ModuleNotFoundError: No module named 'markupsafe._compat'”。
解決方案：
使用pip uninstall markupsafe卸載markupsafe
使用easy_isntall markupsafe重新安裝markupsafe
參考鏈接-python 3.6X安裝notebook后無法打開的解決辦法

2.有的時候命令行下無法啟動Jupyter Notebook
解決方案：
嘗試以管理員身份運行命令行然后再啟動Jupyter Notebook。

1.簡介與基本概念

1.1 簡介

通過Jupyter Notebook中可以在網頁上創建筆記本(Notebook)。筆記本的特性包括：

1. 支持Markdown格式文本。
2. 編輯與運行Python代碼，並將結果直接在筆記中展現。

並且通過第三方服務（nbviewer和github）可以將筆記本發布到網上。
例子如下：

訪問鏈接如下：LearnPython3In90Min

可以利用這特性：

1. 制作包含文本與代碼演示的筆記。這里https://nbviewer.jupyter.org/有很多使用Jupyter Notebook制作的線上筆記。
2. 取代傳統的命令行模式下的交互環境（比如傳統的Idle、IPython），直接在網頁上運行代碼片段並觀察運行結果。

在Jupyter Notebook中有常用的第三方庫的文檔鏈接，如下圖：

1.2 基本概念

筆記本主要由Cell(單元格)組成。
Cell主要有兩種類型:Code(可編寫Python代碼，並運行)與Markdown(可編寫Markdown文本)。
Notebook有兩種模式:Edit Mode與Command mode。

1. Edit Mode(編輯模式)
   該模式下可以鍵入代碼與文本。在單元格上點擊或者按Enter鍵進入該模式。
   綠色邊框代表該Cell處於Edit Mode。
2. Command Mode(命令模式)
   該模式可接收鍵盤快捷鍵。在Edit Mode下可通過按Esc進入該模式。
   灰色邊框且左側有一個藍色條代表該Cell處於Command mode。

2.基本操作

大家可通過Notebook Basics來入門。
摘抄部分常用快捷鍵如下：

2.1 Command Mode

Basic navigation: enter(進入編輯模式), shift-enter(運行單元格中代碼或者渲染單元格中的Markdown文本),up/k(往上移動), down/j(往下移動)
Saving the notebook: s(保存)
Cell types: y(將單元格轉成Code類型), m(轉成markdown), 1-6(分別對應1-6級標題)
Cell creation: a(單元格之上添加單元格), b(單元格之下添加)
Cell editing: x, c, v, z(對指定單元格剪切、拷貝、粘貼、撤銷)，兩次d（刪除）
Kernel operations: 兩次I，終止運行。

2.2 Edit Mode

Tab： code completion or indent(代碼補全或縮進)
Shift-Tab： tooltip
Ctrl-],Ctrl-[：控制縮進 Ctrl+D：刪除行 Ctrl-Y: redo Shift-Enter`: run cell, select below

3.windows下修改Jupyter Notebook工作路徑的簡單方法

首先搜索jupyter-notebook.exe，右鍵發送到桌面快捷方式
右鍵jupyter notebook的快捷方式,屬性-快捷方式-起始位置，將其設置為筆記所在的目錄
參考資料：

windows下修改jupyter notebook工作路徑的簡單方法

4.發布筆記

發布筆記讓大家可以通過網頁訪問主要有兩種方法：

4.1 直接在Github上傳自己的.ipynb文件與文件中的圖片，github可以直接渲染，但速度較慢。
例子如下：
https://github.com/zhrb/NoteBook/blob/master/LearnPython3In90Min.ipynb
GitHub上的Notebook項目

4.2 在Github上傳自己的.ipynb文件與文件中的圖片，然后將該文件的url放入https://nbviewer.jupyter.org/，最后訪生成公開訪問鏈接。
如，將https://github.com/zhrb/NoteBook/blob/master/LearnPython3In90Min.ipynb 放入nbviewer網站，其將生成鏈接https://nbviewer.jupyter.org/github/zhrb/NoteBook/blob/master/LearnPython3In90Min.ipynb。通過該鏈接就可通過Web訪問這個筆記。

5.導出pdf:

將Ipython notebook轉為pdf

參考資料

Jupyter Notebook 快速入門
你為什么使用 Jupyter ，進行分析，而不是用 Python 腳本或僅僅利用 excel ？
左手程序員，右手作家：你必須會的Jupyter Notebook
Jupyter Notebook支持matlab語法
Jupyter kernels
JupyterLab Documentation
利器|JupyterLab 數據分析必備IDE完全指南
在VS Code中使用Jupyter Notebook