2

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

4

0 回答 0