Sphinx 使用旧的模块代码

Question

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

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

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

Answer 1

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

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