4

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

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

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

4

1 回答 1

6

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

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

于 2013-07-01T09:11:59.247 回答