Readthedocs 构建：cmake/swig 不可用

Question

为了构建 readthedocs，我需要安装一些要求。这些 pip 要求之一需要 cmake 和 swig 来构建。

在这种情况下是否仍然可以使用 readthedocs？

Answer 1

似乎已经有一个关于此的问题：https://github.com/rtfd/readthedocs.org/issues/2094

它包含一个解决方法：

对于遇到此问题的任何其他人，您似乎也可以使用'READTHEDOCS' env var 有条件地修改setup.py 中的install_requires。

这指向：

当 RTD 构建您的项目时，它会将 READTHEDOCS 环境变量设置为字符串 True。因此，在您的 Sphinx conf.py 文件中，您可以基于此改变行为。例如：

import os
on_rtd = os.environ.get('READTHEDOCS') == 'True'
if on_rtd:
    html_theme = 'default'
else:
    html_theme = 'nature'

OTOH，最后一条评论声称它应该适用于当前的 RTD 版本。