DEV Community
·
在 Read the Docs 上托管演示文稿
原文英文，约300词，阅读约需2分钟。
📝
内容提要
Read the Docs 是一个文档托管平台，可以与 GitHub 集成，通过 .readthedocs.yaml 文件自动构建和部署文档。支持自定义构建命令，如使用 Pelican 或 Sphinx-Reveal.js 生成 HTML 文件。优点是可以保留旧版本供用户查看，缺点是会在演示中添加广告。
🎯
关键要点
-
Read the Docs (RTD) 是一个文档托管平台，可以与 GitHub 集成。
-
RTD 通过 .readthedocs.yaml 文件自动构建和部署文档。
-
支持自定义构建命令，如使用 Pelican 或 Sphinx-Reveal.js 生成 HTML 文件。
-
RTD 在推送事件时会设置 Python 环境并安装依赖。
-
可以通过 build.commands 属性定义构建内容的程序。
-
RTD 可以保留旧版本供用户查看，方便用户访问历史文档。
-
RTD 在演示中添加广告，且演示不支持完整的 FQDN。
❓
延伸问答
Read the Docs 是什么？
Read the Docs 是一个文档托管平台，可以与 GitHub 集成，自动构建和部署文档。
如何在 Read the Docs 上部署演示文稿？
可以通过在 .readthedocs.yaml 文件中使用 Sphinx-Reveal.js 生成 HTML 文件来部署演示文稿。
Read the Docs 的优缺点是什么？
优点是可以保留旧版本供用户查看，缺点是演示中会添加广告。
如何自定义 Read the Docs 的构建命令？
可以通过 .readthedocs.yaml 文件中的 build.commands 属性定义自定义构建命令。
Read the Docs 如何处理旧版本文档？
Read the Docs 可以保留旧版本文档，方便用户访问历史记录。
Read the Docs 支持哪些构建工具？
Read the Docs 支持使用 Pelican 和 Sphinx-Reveal.js 等工具生成 HTML 文件。
🏷️
