#python #python-sphinx
Вопрос:
У меня проблема с Sphinx автосуммой.
Почти все сценарии, которые у меня есть, обычно документированы без проблем. Однако есть пять сценариев (в одной папке), которые не являются таковыми. Я получаю предупреждение:
WARNING: autosummary: stub file not found ... Check your autosummary_generate setting
В моем файле конф, autosummary_generate это правда, как и должно быть.
Проблема в том, что .rst файлы не создаются для этих файлов. Поэтому я не могу щелкнуть по ним в документации, сгенерированной в формате html.
Я казню сфинкса с sphinx-build -M html docs/source/ docs/_build/ помощью . Кроме того, если я попытаюсь выполнить эту команду дважды, то со второй попытки будут сгенерированы файлы .rst.
Что происходит и с чего я могу начать его отладку?