如何解决Sphinx 无法找到导入的源文件
我对 sphinx 还是很陌生,正在努力让导入为 autodoc 模块工作。目前,我在 conf.py 中添加了以下路径
sys.path.insert(0,os.path.abspath('..'))
sys.path.insert(0,os.path.abspath('../'))
sys.path.insert(0,os.path.abspath('../..'))
sys.path.insert(0,os.path.abspath('../source_code'))
项目结构如下:
Project
| __init__.py
| setup.py
├───docs
│ │ make.bat
│ │ Makefile
| | conf.py
| | index.rst
| | module1.rst
│ ├─── _build
└───src
| module1.py
| module2.py
| __init__.py
| module3.py
Index.rst 内部如下:
.. toctree::
:maxdepth: 1
:caption: Developer's Guide
module1
最后,module1.rst 中的内容如下:
**src.module1**
==============================
.. automodule:: src.module1
:members:
:undoc-members:
:show-inheritance:
但是,当我尝试使用 make html 构建文档时,出现以下错误:
WARNING: autodoc: Failed to import module u'module1' from module u'src'; the following exception was raised:
No module named module2
现在奇怪的是,module1 不导入,甚至不接触 module2。有什么推荐吗?
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。