Я использую Sphinx для документирования своего проекта. когда я запускаю make html, я получаю эту ошибку.
Я установил Sphinx v1.1.2 . В некоторых файлах .rst может быть какая-то ошибка, но это сообщение об ошибке бесполезно, так как я не знаю, какой файл проверить, поскольку у меня более 100 файлов .rst. Поэтому трудно проверять файлы по одному.
Есть ли способ решить эту ошибку или хотя бы выяснить, какой файл ошибочен?
Заранее спасибо.
Проверьте модуль, который обрабатывался непосредственно перед этой ошибкой. В этом модуле, вероятно, отсутствует if __name__ == '__main__' проверка.
Проблема здесь в том, что:
autodoc для извлечения строк документа из файлов .py, когда он встречает директиву autoXXX в первом файле.import, если модуль по умолчанию предполагает, что это только исполняемый файл (т.е. не имеет проверки __main__), вы получите сообщение об ошибке.Боль в ошибке a$$ заключается в том, что большинство разработчиков будут использовать sys.argv[0] и sys.argv[0:] в сообщении об ошибке, отображаемом с неправильными аргументами, в результате чего в этом случае будет напечатано совершенно неуместное сообщение об ошибке.
Если вы используете sphinx-apidoc и ваш пакет использует setuptools с setup.py в той же папке, убедитесь, что вы скрыли setup() вызов в if 'main' == __name__: конструкции.
argparseиспользуется в моем проекте. - person shashaDenovo schedule 12.06.2012