GitHub 页面上的自动构建 Sphinx+Doxygen 文档

Question

我的文档位于/docs 的master 分支。 Sphinx 设置为将构建的文档存储在/docs/build 文件夹中（来源在/docs/source）。如何设置 GitHub 页面以在每次推送时自动构建我的文档？

P.S：在/docs/buildmaster 或/gh-pages 上存储构建页面都可以。

Answer 1

有 4 个 GitHub Actions 帮助了我。

1. Doxygen Action 提取 doxygen 文档
2. Sphinx Action 构建 sphinx 文档（它甚至可以理解 python 的 requirements.txt）
3. Upload Artifact 存储构建的文档
4. GitHub Push 将更改推送到 gh-pages

实际上，我发现使用 GitHub Actions 非常方便。有很多预制的工具，非常好且易于理解。

P.S：我的工作流代码可以在here 找到。随意使用。