我使用Sphinx来记录我的代码,这是一个Python模块的集合。通过擦除我的源代码生成的自动生成的文档很好,但是当我点击直接链接到包含我的包的Sphinx源代码的HTML页面的“代码”链接时,会显示我的代码的旧版本。
我已经尝试删除我的Sphinx生成的文档,从我自己的site-packages
文件夹中卸载软件包,并删除我的build
文件夹中的所有内容。我完全找不到与Sphinx输出相匹配的文件 - 它已经过时了,而且我不知道它来自哪里。有谁知道如何让Sphinx将我的新代码放入文档中?
正如我所说,autodocumentation工作正常,所以它显然在某种程度上解析我的代码。那么为什么纯文本与自动文档不同呢?
Sphinx缓存(pickle)解析源文件。缓存通常位于构建目录下名为.doctrees的目录中。要确保重新分析源文件,请删除此目录。
见http://www.sphinx-doc.org/en/stable/man/sphinx-build.html#cmdoption-sphinx-build-d。