Sphinx autodoc не может импортировать / найти модуль
Я новичок в сфинксе. Я получил что-то в самом начале.
Моя структура файлов действительно проста:
conf.py
index.rst
p1.rst
p1 (документ)
m1.py (файл в p1)
m2.py (файл в p1) ...
в p1.rst пишет:
.. automodule:: p1.m1
:members:
и я добавляю абстрактный путь в conf.py
sys.path.append(os.path.abspath('.'))
Существует проблема, когда я пытался документировать:
... / autodoc.py ", строка 321, в import_object import(self.modname) ImportError: Нет модуля с именем p1.m1
D: \ sph_cheng \ p1.rst: 4: ПРЕДУПРЕЖДЕНИЕ: autodoc не может импортировать / найти модуль 'p1.m1', сообщается об ошибке: "Нет модуля с именем p1.m1", пожалуйста, проверьте правильность написания и sys.path
когда я добавляю следующее в conf.py
sys.path.append(os.path.abspath('p1'))
и изменить в p1.rst
.. automodule:: m1
:members:
оно работает. но мне интересно, должен быть способ, которым мне не нужно добавлять все пути в conf.py
И sphinx-apidoc предоставляет инструкции автомодуля с документами, чтобы показать иерархию. Я не знаю, почему автомодуль с точками не работает для меня.
Есть идеи? Спасибо.
Кстати, работа со Sphinx 1.1.3 и win7