微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

Sphinx 无法找到导入的源文件

如何解决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 举报,一经查实,本站将立刻删除。