python - Readthedocs 上的 Sphinx 错误：“TypeError：'bool' 对象没有属性 '__getitem__'”

Question

Readthedocs 上的文档构建失败，出现一个很难理解的 Sphinx 错误：

Exception occurred:
  File "/home/docs/checkouts/readthedocs.org/user_builds/fluidimage/envs/latest/local/lib/python2.7/site-packages/sphinx/ext/viewcode.py", line 61, in has_tag
  if entry is None or entry[0] != code:
TypeError: 'bool' object has no attribute '__getitem__'

有关完整日志，请参阅https://readthedocs.org/projects/fluidimage/builds/3758665/

我发现其他项目也遇到过同样的问题（链接到谷歌搜索），但这并不能帮助我理解发生了什么。

这个错误是什么意思？如何解决？

Answer 1

这个问题似乎与这个狮身人面像问题有关。虽然 sphinx 已更新自身以允许autodoc_default_options定义为True，但可能是 readthedocs 使用的是旧版本的 sphinx 或由于某种原因无法接受这些值。autodoc_default_options将dict 中的值更改为None允许构建继续。

例子 ：

autodoc_default_options = {
    'members': None, 'undoc-members': None,
    'private-members': None, 'show-inheritance': None
}

Answer 2

所以我的问题的实际答案可以是

• 等待
• 提交修改几乎没有
• 再建...

Sphinx-Readthedocs 错误消失了。至少这是发生在我身上的事情。