一文學(xué)會(huì)設(shè)置 Jupyter 主題與目錄
大家好，我是云朵君!
前兩天因?yàn)槟承┰颍贫渚匮b系統(tǒng)了，發(fā)現(xiàn)以前的一些設(shè)置都沒(méi)有了，因?yàn)橐恍┝?xí)慣，還是想恢復(fù)下以前的一些設(shè)置，如設(shè)置Jupyter notebook 的主題，設(shè)置他的目錄插件等。把設(shè)置的過(guò)程寫出一個(gè)教程，供大家參考。
Jupyter notebook等簡(jiǎn)單介紹
做數(shù)據(jù)科學(xué)的小伙伴們對(duì)Jupyter notebook一點(diǎn)都不陌生，下載安裝anaconda后就可以直接使用了。
下面是官方的一些介紹，參考Jupyter notebook官方文檔[1]
Jupyter notebook將基于控制臺(tái)的方法擴(kuò)展到了一個(gè)全新的方向，提供了一個(gè)基于 Web 的應(yīng)用程序，適用于捕獲整個(gè)計(jì)算過(guò)程：開(kāi)發(fā)、記錄和執(zhí)行代碼，以及交流結(jié)果。Jupyter notebook結(jié)合了兩個(gè)組件：
Web 應(yīng)用程序：一種基于瀏覽器的工具，用于交互式創(chuàng)作文檔，這些文檔結(jié)合了解釋性文本、數(shù)學(xué)、計(jì)算及其豐富的媒體輸出。
Notebook 文檔：Web 應(yīng)用程序中所有可見(jiàn)內(nèi)容的表示，包括計(jì)算的輸入和輸出、解釋性文本、數(shù)學(xué)、圖像和對(duì)象的富媒體表示。
Web應(yīng)用程序的主要功能
- 代碼的瀏覽器內(nèi)編輯，具有自動(dòng)語(yǔ)法突出顯示、縮進(jìn)和制表符完成/內(nèi)省。
- 從瀏覽器執(zhí)行代碼的能力，將計(jì)算結(jié)果附加到生成它們的代碼。
- 使用富媒體表示(例如 HTML、LaTeX、PNG、SVG 等)顯示計(jì)算結(jié)果。例如，可以內(nèi)聯(lián)包含由matplotlib庫(kù)呈現(xiàn)的出版物質(zhì)量的圖形。
- 使用Markdown標(biāo)記語(yǔ)言在瀏覽器中編輯富文本，可以為代碼提供注釋，不限于純文本。
- 能夠使用 LaTeX 在 Markdown 單元格中輕松包含數(shù)學(xué)符號(hào)，并由MathJax本地呈現(xiàn)。
打開(kāi)Jupyter notebook時(shí)出現(xiàn)如下圖所示：
這是官方默認(rèn)的主題，說(shuō)到主題，大家都希望定制適合自己的主題，個(gè)性化嘛。如果我們想要自己定制主題，怎么辦呢?
下面介紹Jupyter-themes修改Jupyter notebook主題的方法。
參考Github地址[2]
環(huán)境準(zhǔn)備
- Python 3.4、3.5、3.6、3.7
- Jupyter(推薦Anaconda[3])
- matplotlib
使用 pip 安裝
- # 安裝 jupyterthemes
- # pip install -i https://pypi.douban.com/simple/ jupyterthemes
- pip install jupyterthemes
- #升級(jí)到最新版本
- pip install --upgrade jupyterthemes
命令行設(shè)置主題
在終端(mac)，anaconda prompt(win)中輸入下面
- # 列出可用的主題
- >>> jt -l
- Available Themes:
- chesterish
- grade3
- gruvboxd
- gruvboxl
- monokai
- oceans16
- onedork
- solarizedd
- solarizedl
- # 選擇主題...
- >>> jt -t chesterish
直接刷新notebook web應(yīng)用程序即可，如果不起作用，請(qǐng)嘗試啟動(dòng)新的Jupyter notebook
如果不喜歡，可以繼續(xù)更換。
- >>> jt -t chesterish
如果還不喜歡，可以繼續(xù)嘗試...不用擔(dān)心，可以恢復(fù)默認(rèn)主題：
- # 注意：運(yùn)行 jt -r 后需要?jiǎng)h除瀏覽器緩存
- >>> jt -r
打開(kāi)工具欄和打開(kāi)notebook名稱，下圖中紅色框部分。
- >>> jt -t grade3 -T -N
除了設(shè)置"模板"主題，還可以自定義，設(shè)置代碼字體/大小、notebook界面字體/大小、單元格寬度和行高等等。
可以設(shè)置 markdown(文本單元格)和notebook(界面)的字體/字體大小。
調(diào)整單元格寬度(% 屏幕寬度)和行高。
- >>> jt -t chesterish -cellw 90% -lineh 170
- >>> jt -t chesterish -cellw 60% -lineh 170
- # 或通過(guò)去掉“%”符號(hào)來(lái)設(shè)置單元格寬度（以像素為單位）
- # >>> jt -t solarizedl -cellw 860
其他的一些設(shè)置。
- # 將代碼字體設(shè)置為 'Roboto Mono' 12pt
- #（參見(jiàn)下面的等寬字體表）
- >>> jt -t onedork -f roboto -fs 12
- # 設(shè)置代碼字體為 Fira Mono, 11.5pt
- # 3digit font-sizes 轉(zhuǎn)換為 float (115-->11.5)
- # 2digit font-sizes > 25 轉(zhuǎn)換為 float (85-->8.5)
- >>> jt -t solarizedd -f fira -fs 115
- # 設(shè)置 markdown（文本單元格）和notebook（界面）的字體/字體大小
- # 請(qǐng)參閱下面的 sans-serif 和 serif 字體表
- >>> jt -t oceans16 -tf merriserif -tfs 10 -nf ptsans -nfs 13
- # 修復(fù)介紹頁(yè)面上的容器邊距（默認(rèn)為“自動(dòng)”）
- >>> jt -t monokai -m 200
- # 調(diào)整光標(biāo)寬度（以像素為單位）并使光標(biāo)變?yōu)榧t色
- # 選項(xiàng)：b（藍(lán)色）、o（橙色）、r（紅色）、p（紫色）、g（綠色）、x（字體顏色）
- >>> jt -t Oceans16 -cursc r -cursw 5
- # 選擇替代提示布局（更窄/沒(méi)有數(shù)字）
- >>> jt -t Grade3 -altp
notebook設(shè)置繪圖樣式
jtplot.style()對(duì) matplotlib 的 rcParams 字典進(jìn)行更改。
jtplot.style()設(shè)置配色方案各種圖形屬性(spines, grid, font scale, etc) 以及繪圖 "context"
這些命令不需要在每次生成新繪圖時(shí)重新運(yùn)行，只需在筆記本開(kāi)頭或之后需要更改樣式時(shí)重新運(yùn)行一次。
- # import jtplot module in notebook
- from jupyterthemes import jtplot
- # 從下主題中選擇以繼承繪圖風(fēng)格的主題
- # onedork | grade3 | oceans16 | chesterish | monokai | solarizedl | solarizedd
- jtplot.style(theme='onedork')
以各地打工人工資表為例。
縮放刻度標(biāo)簽、圖例等的字體大小。從 x 和 y 軸移除脊椎并使網(wǎng)格虛線：
打開(kāi) X 軸和 Y 軸刻度線(默認(rèn) = False)，關(guān)閉軸網(wǎng)格線(默認(rèn) = True)，并設(shè)置默認(rèn)圖形大小。
上面已經(jīng)將主題部分介紹完畢了，大家可以動(dòng)手試試。設(shè)置自己喜歡的主題吧。
Jupiter notebook安裝目錄
下面開(kāi)始介紹目錄的安裝。一個(gè)notebook怎能沒(méi)有目錄?其安裝目錄也比較簡(jiǎn)單。但還是有不少小伙伴會(huì)經(jīng)常猜坑，下面一起看看目錄的正確打開(kāi)方式吧。
首先安裝目錄插件。
可以在Jupiter notebook里運(yùn)行，也可在終端運(yùn)行如下代碼：
- pip install jupyter_contrib_nbextensions -i https://pypi.douban.com/simple
若在Jupiter notebook里運(yùn)行安裝后，需要關(guān)閉Jupiter notebook，在終端運(yùn)行。
jupyter contrib nbextension install --user --skip-running-check
注意配置的時(shí)候要確保沒(méi)有打開(kāi) Jupyter Notebook 。
啟動(dòng) Jupyter Notebook，開(kāi)啟目錄。
上面兩個(gè)步驟都沒(méi)報(bào)錯(cuò)后，啟動(dòng) Jupyter Notebook，上面選項(xiàng)欄會(huì)出現(xiàn) Nbextensions 的選項(xiàng)。
點(diǎn)開(kāi) Nbextensions 的選項(xiàng)，并勾選 Table of Contents 。
打開(kāi)一個(gè) .ipnb 文件，工具欄就會(huì)出現(xiàn)目錄選項(xiàng)，點(diǎn)擊就會(huì)生成目錄。
OK，小伙伴們都學(xué)會(huì)了沒(méi)，可以動(dòng)手試試。
參考資料
[1]Jupyter notebook官方文檔: https://jupyter-notebook.readthedocs.io/en/latest/notebook.html
[2]Github地址: https://github.com/dunovank/jupyter-themes
[3]Anaconda: https://www.continuum.io/downloads
