触れたくない多くの外部ライブラリを含む大規模なPythonプロジェクトがあり、sphinxを使用してドキュメントを生成したいと思います。私の問題は、「make html」を実行するたびに、次のエラーが発生することです。
...
usage: sphinx-build [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
or: sphinx-build --help [cmd1 cmd2 ...]
or: sphinx-build --help-commands
or: sphinx-build cmd --help
error: option -b not recognized
make: *** [html] Fehler 1
この問題は、文書化するディレクトリの一部にOptionParserがある場合に発生することをすでに理解しています（OptionParserはsphinxと競合していますか？）。私は実際にそれらのディレクトリでOptionParserを使用し、それをでラップしない多くのスクリプトを持っていif __name__ == "__main__": ...ます。私の質問は：
これらのスクリプトに触れずにドキュメントを生成するにはどうすればよいですか？
それらのファイル/パスを除外する方法はありますか？conf.pyでexclude_patternsを試しましたが、機能しませんでした。何故かはわからない。そのエラーをキャッチする方法はありますか？
アップデート
setup.py問題は、によって解析されたツリー内のファイルであることが判明しましたautodoc。