python – sphinx在执行’make html’时运行我的代码吗？

我继承了一个相当大的代码库,我想为它创建html文档.由于它是用 Python编写的,所以我决定使用sphinx,因为代码的用户习惯于使用sphinx创建的python文档的设计和功能.
我使用命令sphinx-apidoc自动创建rst文件.我将模块路径导入sys.path,以便sphinx可以找到代码.

到现在为止还挺好.但是,当我尝试使用命令make html创建html时,会弹出许多回溯,并且代码库中的一些示例似乎已被执行.可能是什么原因以及如何防止这种情况发生？

解决方法

您可能必须以不同的方式组织代码以使错误消失(将模块级代码移动到函数).有关可能发生的情况的示例,请参见this question.

这是我的猜测,但可能不是整个故事.没有其他信息,很难说更多.

（编辑：安卓应用网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!