Я использую аннотацию sphinx-autodoc, чтобы прочитать аннотации функций в моем коде Python и использовать их для генерации подходящих ожидаемых типов аргументов и возвращаемых типов. Он отлично работает на моей локальной машине, но я должен был pip install sphinx-autodoc-annotation
, конечно.Как настроить Read the Docs для использования аннотации sphinx-autodoc?
Я пытаюсь создать такую же документацию, используя Read the Docs, но это дает мне ошибку:
Could not import extension sphinx_autodoc_annotation (exception: No module named sphinx_autodoc_annotation)
Можно ли настроить Читайте Документы для работы с сфинкса-AutoDoc-аннотацией, а если так , как я могу заставить его работать?
Это близко, но пока не работает. Я добавил 'requirements.txt' в папку' docs' (так как это нужно только для сборки документов, а не для самого проекта), указав на то, что в настройках RtD включено: «Установите свой проект внутри virtualenv, используя setup.py установить». Я не получаю ошибок, но теперь он не создает файл 'py-modindex.html', который он создает, когда я запускаю Sphinx локально. Я думаю, что мне нужно опубликовать этот вопрос со всеми этими дополнительными деталями. – Chuck