Я новичок как в Python, так и в Sphinx, и я пытаюсь скопировать файлы Python в autodoc, расположенные в каталоге, структура которого аналогична следующей:
Project
├── Sphinx
| ├── index.rst
| ├── autodoc.rst
| └── conf.py
├── Scripts
| ├── file1.py
| └── file2.py
| ├── folder
| | └── file3.py
Мой файл conf.py содержит:
sys.path.insert(0, os.path.abspath("../Scripts/"))
А автодок содержит:
.. automodule:: file1
:members:
.. automodule:: file2
:members:
.. automodule:: folder.file3
:members:
File3.py не автодокументируется правильно (ошибка: нет модуля с именем metric.billpay)
Я также пробовал:
.. automodule:: folder/file3
:members:
Но я получаю
ВНИМАНИЕ: недействительная подпись для автоматического режима (u'folder / file3 ')
ВНИМАНИЕ: не знаю, какой модуль импортировать для автодокументирования u'folder / file3 '(попробуйте поместить в документ директиву «module» или «currentmodule» или указать явное имя модуля)
Кто-нибудь знает, как это исправить? Я новичок в Python, Sphinx и StackOverflow, поэтому приношу свои извинения, если есть проблемы с этим вопросом.