把 Jupyter Notebook 变成网页

我的写作基础设施：

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

本合集会一一介绍上述工具的安装、配置、使用等等

还会介绍：

• 
  
  
  服务器配置
  


• 
  
  
  GitHub Pages、Cloudflare Pages、Vercel 的使用
  


• 
  
  
  用 Jekyll、Bookdown、Jupyter Book、Astro 搭建个人博客
  

预计更新 12 个章节，欢迎订阅。

前文

P1:技术写作，工具篇

P2:本地运行“小型”大模型，配合笔记应用王者 Obsidian 做知识管理

P3:世界上最好的 Markdown 编辑器，Typora 完全配置指南，Markdown 极简入门

P4:搭建完美写作环境之：Typora+PicGo 快速上传图片

P5:互联网活菩萨 Cloudflare 的“免费”图床

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

P7:用 mdnice 做 Markdown 主题美化

P8:用 GitHub 备份 Markdown 文档，Git 简介

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

P10:用R Bookdown做本书，上线

本文目录

• Jupyter Book 简介




• 创建 Jupyter Book 的步骤

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

Jupyter Book 是一个开源工具，它允许用户从一组 Jupyter 笔记本和 Markdown 文件创建文档页面。非常适合将数据分析、研究结果、教程或课程材料转化为易于阅读和分享的格式的用户，可以借助GitHub Pages 或 vercel部署成网站。

Jupyter Book 简介

Jupyter Book 基于 Python 语言，使用 Sphinx 文档生成工具，支持 MyST（Markdown for Sphinx）语法，这使得它能够支持丰富的 Markdown 文本和执行代码。它可以集成多种格式，包括纯文本、代码、数学公式，甚至可以插入交互式内容，如 HTML 小部件和 JavaScript 交互元素。

主要特点

1. 
   
   
   多格式支持：Jupyter Book 支持 Markdown 和 Jupyter 笔记本格式，可以轻松地将研究代码和文本内容结合起来。
   


2. 
   
   
   交互性：可以包含交互式组件，如 Jupyter 笔记本内的代码单元，读者可以直接在网页上运行。
   


3. 
   
   
   扩展性：通过插件和扩展，Jupyter Book 可以支持公式、图表、引用和更多高级文档功能。
   


4. 
   
   
   版本控制友好：Jupyter Book 项目容易与 Git 等版本控制系统配合使用，便于团队合作和项目历史记录。
   

Jupyter Book 还支持许多其他功能，例如：

• 
  
  
  创建多页面书籍
  


• 
  
  
  添加目录和脚注
  


• 
  
  
  自定义样式
  


• 
  
  
  使用 Sphinx 扩展程序
  


• 
  
  
  将书籍部署到网站
  

创建 Jupyter Book 的步骤

1. 安装

首先，你需要在你的计算机上安装 Jupyter Book，这可以通过 pip 完成：

pip install jupyter-book

2. 创建

创建一个新的 Jupyter Book 很简单，只需运行下面的命令：

jupyter-book create mynewbook

这将在当前目录下创建一个名为 mynewbook 的新文件夹，其中包含开始工作所需的所有基础文件。你可以添加 Jupyter 笔记本（.ipynb 文件）和/或 Markdown 文件（.md 文件）。

2. 
   
   
   在该目录下会生成一些文件,最重要的是_config.yml配置文件和_toc.yml目录层级文件。
   

3. 配置

你可以在 _toc.yml 文件中配置这些文件的顺序和结构，这是定义书籍结构的目录文件。

编辑_toc.yml文件,添加各个章节路径,比如: