把 Jupyter Notebook 變成網(wǎng)頁

我的寫作基礎設施：

1、Typora
2、Cloudflare R2
3、Picgo
4、Obsidian
5、GitHub
6、mdnice

本合集會一一介紹上述工具的安裝、配置、使用等等

還會介紹：

• 服務器配置
• GitHub Pages、Cloudflare Pages、Vercel 的使用
• 用 Jekyll、Bookdown、Jupyter Book、Astro 搭建個人博客

預計更新 12 個章節(jié)，歡迎訂閱。

前文

P1:技術寫作，工具篇

P2:本地運行“小型”大模型，配合筆記應用王者 Obsidian 做知識管理

P3:世界上最好的 Markdown 編輯器，Typora 完全配置指南，Markdown 極簡入門

P4:搭建完美寫作環(huán)境之：Typora+PicGo 快速上傳圖片

P5:互聯(lián)網(wǎng)活菩薩 Cloudflare 的“免費”圖床

P6:知識管理王者，我的第二大腦，Obsidian 配置指南

P7:用 mdnice 做 Markdown 主題美化

P8:用 GitHub 備份 Markdown 文檔，Git 簡介

P9:Jekyll + Vercel 搭建個人博客，完整教程》

P10:用R Bookdown做本書，上線

本文目錄

• Jupyter Book 簡介

• 創(chuàng)建 Jupyter Book 的步驟

Jupyter Notebook 大家都耳熟能詳了，但是Jupyter book 大家可能就沒那么熟悉了。

Jupyter Book 是一個開源工具，它允許用戶從一組 Jupyter 筆記本和 Markdown 文件創(chuàng)建文檔頁面。非常適合將數(shù)據(jù)分析、研究結果、教程或課程材料轉化為易于閱讀和分享的格式的用戶，可以借助GitHub Pages 或 vercel部署成網(wǎng)站。

Jupyter Book 簡介

Jupyter Book 基于 Python 語言，使用 Sphinx 文檔生成工具，支持 MyST（Markdown for Sphinx）語法，這使得它能夠支持豐富的 Markdown 文本和執(zhí)行代碼。它可以集成多種格式，包括純文本、代碼、數(shù)學公式，甚至可以插入交互式內容，如 HTML 小部件和 JavaScript 交互元素。

主要特點

1. 多格式支持：Jupyter Book 支持 Markdown 和 Jupyter 筆記本格式，可以輕松地將研究代碼和文本內容結合起來。
2. 交互性：可以包含交互式組件，如 Jupyter 筆記本內的代碼單元，讀者可以直接在網(wǎng)頁上運行。
3. 擴展性：通過插件和擴展，Jupyter Book 可以支持公式、圖表、引用和更多高級文檔功能。
4. 版本控制友好：Jupyter Book 項目容易與 Git 等版本控制系統(tǒng)配合使用，便于團隊合作和項目歷史記錄。

Jupyter Book 還支持許多其他功能，例如：

• 創(chuàng)建多頁面書籍
• 添加目錄和腳注
• 自定義樣式
• 使用 Sphinx 擴展程序
• 將書籍部署到網(wǎng)站

創(chuàng)建 Jupyter Book 的步驟

1. 安裝

首先，你需要在你的計算機上安裝 Jupyter Book，這可以通過 pip 完成：

pip install jupyter-book

2. 創(chuàng)建

創(chuàng)建一個新的 Jupyter Book 很簡單，只需運行下面的命令：

jupyter-book create mynewbook

這將在當前目錄下創(chuàng)建一個名為 mynewbook 的新文件夾，其中包含開始工作所需的所有基礎文件。你可以添加 Jupyter 筆記本（.ipynb 文件）和/或 Markdown 文件（.md 文件）。

2. 在該目錄下會生成一些文件,最重要的是_config.yml配置文件和_toc.yml目錄層級文件。

3. 配置

你可以在 _toc.yml 文件中配置這些文件的順序和結構，這是定義書籍結構的目錄文件。

編輯_toc.yml文件,添加各個章節(jié)路徑,比如: