Sphinx 使用旧的模块代码

Question

我使用 Sphinx 来记录我的代码，它是 Python 模块的集合。通过清理我的源代码生成的自动生成的文档很好，但是当我单击直接链接到包含 Sphinx 生成的包源的 HTML 页面的“代码”链接时，会显示我的代码的旧版本。

我尝试删除我的 Sphinx 生成的文档，从我自己的 site-packages 文件夹中卸载包，并删除我的 build 文件夹中的所有内容。我绝对找不到与 Sphinx 的输出相匹配的文件——它很旧，而且我不确定它来自哪里。有人知道如何让 Sphinx 将我的新代码放入文档中吗？

正如我所说，自动文档工作正常，所以它显然在某种程度上解析了我的代码。那么为什么纯文本与自动文档不同呢？

Answer 1

Sphinx 缓存（pickles）解析的源文件。缓存通常位于 build 目录下名为 .doctrees 的目录中。为确保您的源文件被重新解析，请删除此目录。

见http://www.sphinx-doc.org/en/stable/man/sphinx-build.html#cmdoption-sphinx-build-d。