我有一个大型 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
.