2016-08-28 1 views
1

Я использую аннотацию 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-аннотацией, а если так , как я могу заставить его работать?

ответ

1

Активируйте опцию Установить проект для ознакомления с проектом Docs.

Если этот параметр активирован, прочитайте документы, которые попытаются выполнить setup.py install на вашем пакете (см.: RtD docs). В setup.py вы можете установить пакеты, указанные в вашем requirements file. Например, source code of the Flask-MongoRest project.

Добавить sphinx-autodoc-annotation как единственное требование к вашему requirements.txt файлам.

+0

Это близко, но пока не работает. Я добавил 'requirements.txt' в папку' docs' (так как это нужно только для сборки документов, а не для самого проекта), указав на то, что в настройках RtD включено: «Установите свой проект внутри virtualenv, используя setup.py установить». Я не получаю ошибок, но теперь он не создает файл 'py-modindex.html', который он создает, когда я запускаю Sphinx локально. Я думаю, что мне нужно опубликовать этот вопрос со всеми этими дополнительными деталями. – Chuck

 Смежные вопросы

  • Нет связанных вопросов^_^