使用 makefile 在 RTD 中构建文档答案

【问题标题】：Building documentation in RTD using a makefile使用 makefile 在 RTD 中构建文档
【发布时间】：2021-10-08 10:04:36
【问题描述】：

我为 sagemath 创建了一个包，并使用 Sphinx 创建了它的文档。现在我正在尝试创建必要的配置文件来构建 readthedocs 中的文档。

我遇到的问题是，为了构建文档，我必须在 sagemath shell 中运行 sphinx（即 sage -sh -c "make html"）。

有没有办法通过 readthedocs 的配置文件来实现这一点？或者使用生成文件来构建文档？似乎找不到关于他们的文档的信息。

【问题讨论】：

【解决方案1】：

目前，阅读文档具有包括呼叫@ 987654324固定构建过程@（有一些更多的参数）从其中安装的要求，虚拟环境。这描述in the documentation P>

因此，运行自定义命令是不可能的。 P>

然而，由于sage is available from conda和Read the Docs supports conda environments，你也许可以建立的文档，而不必调用一个圣人外壳。 P>

【讨论】：