如何解决Sphinx 从过时的源代码生成 HTML 输出
我正在使用 Sphinx 生成 HTML 文档。一切正常,但由于某种原因,生成的 HTML 文件中的源代码和注释确实过时了。我什至不明白这怎么可能。我已经多次删除所有文件并再次生成它,仍然是同样的问题。
解决方法
我遇到了完全相同的问题。就我而言,我有一个旧版本的软件包,我记录了它是通过 pip 安装的,这是 sphinx 用来构建文档的源。删除旧版本
pip uninstall <my_pkgname>
解决了这个问题。
您是否将 autodoc
扩展程序与 sphinx-apidoc
util 一起使用?
如果是这样,那么考虑到文档位于 doc/source
目录中,您可能需要重新生成包中 docs
的内容。
$ cd docs
$ rm -r source
$ sphinx-apidoc -o source ../<package_name>
此处的 ../<package_name>
用于提供包内容的路径。
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。