带有 Jupyter 的书籍 ¶
Jupyter Book 是一个开源项目,用于从计算材料中构建漂亮的、具有出版质量的书籍和文档。
以下是 Jupyter Book 的一些特点:
出版质量内容 ✍
使用 Jupyter Markdown, MyST Markdown,以及更多 发布功能 的 reStructuredText,Jupyter Notebooks,或 任何 Jupytext 格式。包括对富文本语法的支持,如引用和交叉引用、数学和等式,以及 图像。
执行笔记本单元格,然后格式化并将最新输出插入到您的书中。缓存输出以节省稍后重建的时间。甚至保存笔记本输出并插入到其他页面。
创建交互式内容块,如 Tabbed content、Dropdowns。切换单元格可见性,并包含与 Jupyter 笔记本 交互的单元格输出。使用 Binder 或 Colab 启动互动会话,让你的代码在 Thebe 上可执行,或 与像 Hypothes.is 这样的评论服务连接。
本文档分为几个主要部分。
教程是 Jupyter Book 的由浅入深的介绍性指南。
主题指南更深入地涵盖了特定领域,并被组织为离散的“如何做”部分。
参考章节详细描述了 Jupyter Book 的 API/语法 等细节。
这个网站就是 Jupyter Book 建立的!探索左边的章节来了解更多!
了解更多并参与其中
- 💡 打开议题
通过 GitHub issue 跟踪增强请求、bug 报告和待办事项。
- 💬 加入讨论
在社区论坛上进行社区议论,讨论想法,分享一般性问题和反馈。
- 👍 为新功能投票
社区通过在我们的存储库中添加👍对问题的反应来提供反馈。您可以在 Executable Books 问题排行榜 中找到一个最重要的问题列表。
- 🙌 对 Jupyter Book 有所贡献
Jupyter Book 是由 可执行书籍社区 开发的。我们欢迎任何人加入我们,改善 Jupyter Book,并帮助彼此学习和创建他们的书。要加入,请查看我们的 贡献指南。
找到正确的文档资源¶
这里有一些建议可以帮助你开始。
快速入门
Create your first book:一个循序渐进的入门教程。
Create books automatically:从一本简单的模板书开始。
了解更多
Structure and organize content:学习如何结构化和组织内容。
Write narrative content:学习如何写丰富的叙事性内容。
Write executable content:编写计算性内容。
灵感
The Jupyter Book Gallery:包含大量由 Jupyter Book 创建书籍的社区画廊。
The QuantEcon Python Lectures:一个由自定义 Jupyter Book 主题构建的完整的数学教科书。