把 Jupyter Notebook 变成网页
共 2154字,需浏览 5分钟
·
2024-04-28 11:00
我的写作基础设施:
1、Typora
2、Cloudflare R2
3、Picgo
4、Obsidian
5、GitHub
6、mdnice
本合集会一一介绍上述工具的安装、配置、使用等等
还会介绍:
-
服务器配置 -
GitHub Pages、Cloudflare Pages、Vercel 的使用 -
用 Jekyll、Bookdown、Jupyter Book、Astro 搭建个人博客
预计更新 12 个章节,欢迎订阅。
前文
P2:本地运行“小型”大模型,配合笔记应用王者 Obsidian 做知识管理
P3:世界上最好的 Markdown 编辑器,Typora 完全配置指南,Markdown 极简入门
P4:搭建完美写作环境之:Typora+PicGo 快速上传图片
P6:知识管理王者,我的第二大脑,Obsidian 配置指南
P8:用 GitHub 备份 Markdown 文档,Git 简介
P9:Jekyll + Vercel 搭建个人博客,完整教程》
本文目录
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 交互元素。
主要特点
-
多格式支持:Jupyter Book 支持 Markdown 和 Jupyter 笔记本格式,可以轻松地将研究代码和文本内容结合起来。 -
交互性:可以包含交互式组件,如 Jupyter 笔记本内的代码单元,读者可以直接在网页上运行。 -
扩展性:通过插件和扩展,Jupyter Book 可以支持公式、图表、引用和更多高级文档功能。 -
版本控制友好: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 文件)。
-
在该目录下会生成一些文件,最重要的是 _config.yml
配置文件和_toc.yml
目录层级文件。
3. 配置
你可以在 _toc.yml
文件中配置这些文件的顺序和结构,这是定义书籍结构的目录文件。
编辑_toc.yml
文件,添加各个章节路径,比如: