在GitHub页面上自动构建Sphinx+氧文档

Question

我的文档位于master分支上的/docs。Sphinx设置为在/docs/build文件夹中存储构建的文档(源代码在/docs/source中)。我如何设置GitHub页面与每次推送自动构建我的文档?

p。S:在master上存储/docs/build中的构建页面或在gh-pages上存储/中的构建页面都OK。

Answer 1

有4个GitHub行动，帮助我与它。

1. 氧操作提取氧文件
2. Sphinx构建Sphinx文档的动作(它甚至理解python的requirements.txt)
3. 上传工件以存储已构建的文档
GitHub Push将更改推送到gh-pages

实际上，我发现使用GitHub Actions非常方便。有很多现成的工具都很好，很容易理解。

p。S:我的工作流代码可以在这里找到。请随意使用