---
tags: slide, Jupyter
---

# JupyterLab<br>調整懶人包

---

## 目標：用起來像 MatLab <br>(或 RStudio)

預設的 JupyterLab 缺乏甚麼？

- [ ] 啟動：點開捷徑就能啟動
- [ ] GUI：不要像瀏覽器(URL列、Tabs列不可出現、要有專屬狀態列)
- [ ] 功能：程式碼美化、變數瀏覽、版本控制、文件結構樹狀大綱
- [ ] (加碼)：多語言支援、fira code 字體

#### 這些通通有解!!!

---

## 啟動 JupyterLab

基本上高尚的大家應該要這樣開啟

cd "說好的資料夾"
jupyter lab

---

但我很懶怎麼辦？做捷徑(ICON [載點](https://github.com/jupyterlab/jupyterlab_app/blob/master/dist-resources/icon.ico))

...\Anaconda3\Scripts\jupyter-lab.exe “說好的資料夾”


---

## 以 chrome app mode 啟用

- 這樣還是會有醜醜的 URL 欄位，第一次建立 jupyter_notebook_config.py 檔案請使用命令

  jupyter notebook --generate-config

- 執行後會回報位置資料夾，請至資料夾開啟 jupyter_notebook_config.py 增加設定

  c.NotebookApp.browser = ".../chrome.exe --app=%s"

---

這樣就賞心悅目了~~


---

- [x] 啟動：~~點開捷徑就能啟動~~
- [ ] GUI：不要像瀏覽器(~~URL列~~、~~Tabs列不可出現~~、要有專屬狀態列)
- [ ] 功能：程式碼美化、變數瀏覽、版本控制、文件結構樹狀大綱
- [ ] (加碼)：多語言支援、fira code 字體

---

之後有些外掛也可能要修改設定，<br>大致上在以下五處：

1. `.../.jupyter/jupyter_notebook_config.py`
2. `.../.jupyter/custom/custom.js`
3. (Lab跟Notebook共通)View 選單
4. Lab 的 Setting 選單
5. Lab 的 Advanced Settings (Ctrl+,)

---

## 多重 Kernel 安裝

Jupyter 支援多重 Kernel (可執行的語言核心)，加上 Anaconda 可以安裝虛擬版本的 Python 環境，所以我們的 Luncher 可以很壯觀：


---

### Python X.X.X/ X.X/ X

建立一個名叫 `py36` 的 Python 3.6 環境
加到 kernels 裡面叫做 `python3.6`
平常使用時會顯示「Python 3.6」：

  # -n 是虛擬環境命名 python= 是指定版本號(可以3，可以3.6，可以3.6.8)
  conda create -n py36 python=3.6
  # 啟用環境 Windows 版
  activate py36
  # 啟用環境 Mac/Linux 版
  source activate py36
  # 在環境安裝 ipykernel
  pip install ipykernel
  # --name 後面接的是 kernels 命名 --display-name 後面接的是顯示名稱
  python -m ipykernel install --user --name python3.6 --display-name "Python   3.6"
  # 退出虛擬環境
  deactivate

---

#### 假如我們不想要了

jupyter kernelspec uninstall python3.6

# 假如不知道有那些 kernal 名稱用下面調來看
jupyter kernelspec list
# 假如連虛擬環境都不要
conda env remove --name py36
# 假如不知道有那些虛擬環境名稱用下面調來看
conda env list

---

### R Kernel

R
install.packages('IRkernel',
                 repos = 'https://cloud.r-project.org/')
IRkernel::installspec(user = FALSE)

### Juila Kernel

julia
using Pkg
Pkg.add("IJulia")

---

- [x] 啟動：~~點開捷徑就能啟動~~
- [ ] GUI：不要像瀏覽器(~~URL列~~、~~Tabs列不可出現~~、要有專屬狀態列)
- [ ] 功能：程式碼美化、變數瀏覽、版本控制、文件結構樹狀大綱
- [x] (加碼)：~~多語言支援~~、fira code 字體

---

## JupyterLab Extension Manager

Setting -> Advanced Settings (Ctrl+,) 開啟設定，在 Extension Manager 加入 `{"enabled": true}`


---

### 安裝 node.js

- 許多 Lab 的外掛都是用 node.js 或 npm 部屬，需要先安裝才能安裝外掛，Anaconda 可以用 conda 的方式安裝 node.js

  conda install nodejs

- 但上面的版本很舊，有些外掛會需要新版 node.js ，請至官網安裝最新的 LTS 版(長期支援版)

---

啟用 Extension Manager 之後就會出現這個介面


---

### 安裝外掛，以及要記得 Rebuild

1. 一般來說安裝外掛大致長這樣(不建議用剛剛的 Extension Manager 安裝)

   # 可能需要先透過 pip 或 conda 安裝其他東西
   jupyter labextension install 外掛名稱
   # 有些外掛會要求安裝後還有後續設定
   # 有些透過 npm 部屬
   npm i 外掛名稱

2. Rebuild JupyterLab

   jupyter lab build
   
   # 只有 jlpm 是例外
   jlpm build

---

## 有甚麼好 labextension 外掛?

- 美化程式碼：
`@ryantam626/jupyterlab_code_formatter` (須配合 Python Package `black`/`yapf`/`autopep8` 三者至少一個)

- 變數監看：
`@lckr/jupyterlab_variableinspector`

- 自定義字體：
`@deathbeds/jupyterlab-fonts`
(搭配 `@deathbeds/jupyterlab-font-fira-code`)

---

- Open .md With Notebook：
`notedown`(非 labextension)

- 支援 `ipywidgets`：
`@jupyter-widgets/jupyterlab-manager`

- 表格瀏覽：`jupyterlab-spreadsheet`
- draw.io：`jupyterlab-drawio`
- 目錄表：`@jupyterlab/toc`
- 狀態列：`@jupyterlab/statusbar`

---

- [x] 啟動：~~點開捷徑就能啟動~~
- [x] GUI：~~不要像瀏覽器~~(~~URL列~~、~~Tabs列不可出現~~、~~要有專屬狀態列~~)
- [x] 功能：~~程式碼美化~~、~~變數瀏覽~~、版本控制(透過 Git 外掛)、~~文件結構樹狀大綱~~
- [x] (加碼)：~~多語言支援~~、~~fira code 字體~~
- [x] (!再加碼)：~~表格檔瀏覽~~、~~流程圖繪圖~~、(還沒介紹：互動模組整合)

---

## 之前避談的事情：<br>一些小的編輯器功能

(輔助線、程式碼折疊等)

- 有外掛可以用 VS Code 取代預設編輯器但個人尚未嘗試成功
- Jupyter Notebook 的 nbextension 其實做得很好但 JupyterLab 目前無法使用

---

### 展望：JupyterLab 1.0

- 官方說 1.0 版 2018 年底會出來，目前 alpha3 版，github 上顯示完成度約 88%。
- 官方宣稱未來 JupyterLab 1.0 會取代現在的 Jupyter Notebook 。
- 不過官方承諾應該會讓大多數 Jupyter Notebook 的外掛可以安裝於 JupyterLab 。

---

### Notebook 的外掛大補帖

- 安裝 jupyter_contrib_nbextensions

conda install -c conda-forge jupyter_contrib_nbextensions

- 之後進 Jupyter Notebook 設定即可


---

## 小結語：幾乎功能完整的 IDE