我使用Sphinx记录我的代码,该代码是Python模块的集合.通过清理我的源代码制作的自动生成的文档很好,但是当我单击直接链接到包含Sphinx生成的包含包源代码的HTML页面的“代码”链接时,将显示我的代码的较旧版本.
我试图删除我的Sphinx生成的文档,从自己的site-packages文件夹中卸载该软件包,并删除build文件夹中的所有内容.我找不到与Sphinx输出匹配的文件-它很旧,而且我不确定它来自哪里.有人知道如何让Sphinx将我的新代码放入文档中吗?
正如我所说,自动文档工作正常,因此显然可以在某种程度上解析我的代码.那么,为什么纯文本与自动文档有所不同?
解决方法:
Sphinx缓存(修补程序)已解析的源文件.缓存通常位于build目录下的.doctrees目录中.为了确保您的源文件被解析,请删除该目录.
参见http://www.sphinx-doc.org/en/stable/man/sphinx-build.html#cmdoption-sphinx-build-d.