如何在 readthedocs 构建时删除 doctest 标志？

Question

我已经发布了我的 Python 包并将文档托管在 readthedocs 上。

我想知道如何从文档中删除 doctest 标志（例如 doctest: +ELLIPSIS）：

https://camphr.readthedocs.io/en/doc-doctest/

当我在本地计算机 (make html) 中构建文档时，标记被正确删除。

Answer 1

我找到了解决方案。

Read-the-docs 默认安装 sphinx<2，其中有一个 doctest 标志的错误（请参阅@mzjn 评论）。 因此我准备了 readthedocs.yml:

...
python:
  install:
    - requirements: docs/requirements.txt

并准备docs/requirements.txt如下：

sphinx>=2.2

现在 readthedocs 安装 sphinx>=2.2 一切正常。