【原】用 Jupyter Notebook 寫書

進(jìn)擊的Grey 2023-11-27 發(fā)布于廣東

展開(kāi)全文

自從 Python 在數(shù)據(jù)科學(xué)方面火熱起來(lái)之后，應(yīng)該很少有人對(duì) Jupyter Notebook 不熟悉的，因?yàn)樽鰯?shù)據(jù)分析或數(shù)據(jù)處理，它可以說(shuō)是必備的一個(gè)工具。但是，你可能不知道是，Jupyter 還可以用來(lái)寫書，真實(shí)的效果比起 Gitbook 其實(shí)也是差不了多少的。

之所以能用來(lái)寫書，是因?yàn)?Jupyter 出了一個(gè)類似 bookdown 的工具，叫做 Jupyter Book。今天我們要介紹的，就是如何利用 Jupyter Book 將你的技術(shù)筆記或經(jīng)驗(yàn)沉淀下來(lái)，變成一本在線書籍發(fā)表哦。

什么是 Jupyter Book？

Jupyter Book 背后的概念，其實(shí)很簡(jiǎn)單：

將 .ipynb 文件，轉(zhuǎn)換成 Markdown 文件然后使用 Jekyll 生成靜態(tài)網(wǎng)頁(yè)

靠著這個(gè)機(jī)制，可以順利地將 Jupyter Notebook 文件和 Markdown 文件渲染成網(wǎng)頁(yè)。官網(wǎng)上介紹了幾個(gè)特性，比較厲害的有：

支持直接下載 ipynb 文件
可自動(dòng)添加 Binder、JupyterHub、Theblab 等平臺(tái)的鏈接
快速導(dǎo)航、隱藏代碼塊等等

如何上手？

安裝

可以使用 pip ，在終端快速安裝 Jupyter Book 的命令行（對(duì)，提供了方便的命令行操作）：

pip install jupyter-book

創(chuàng)建新書

安裝之后，可以使用官網(wǎng)提供的 demo 創(chuàng)建一本新書：

jupyter-book create mybookname --demo

執(zhí)行完命令行，你就可以在指定的目錄下找到生成的文件，結(jié)構(gòu)如下：

mybookname/
├── assets
│   └── custom
│       ├── custom.css
│       └── custom.js
├── _config.yml
├── content
│   ├── features
│   │  ├── features.md
│   │  └── notebooks.ipynb
│   └── LICENSE.md
├── _data
│   └── toc.yml
└── requirements.txt