我该如何解决大型项目中OptionParser和sphinx-build的冲突?

时间:2013-02-08 09:59:01

标签: python python-sphinx optionparser

我有一个庞大的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时会出现此问题(Is OptionParser in conflict with sphinx?)。实际上我有很多脚本在这些目录中使用OptionParser而不用if __name__ == "__main__": ...包装它。我的问题是:

如何在不触及任何这些脚本的情况下生成文档?

有没有办法排除这些文件/路径?我已经在conf.py中尝试过exclude_patterns,但这不起作用。我不知道为什么。 有没有办法捕捉到这个错误?

更新

该问题原来是由setup.py解析的树中的autodoc文件。

0 个答案:

没有答案