关于 python:Sphinx toctree 指令在更新后停止工作

Sphinx toctree directive stopped working after update

从fedora 20更新到21后,我常规生成的sphinx HTML文档突然停止显示目录树。模板仍然没有改变,并且包含

1
2
3
      {%- block sidebartoc %}
      {{ toctree() }}
      {%- endblock %}

以前用于创建目录树,但现在在生成的 div 中看不到目录的证据。

没有给出警告或错误,所以我真的不知道从哪里开始寻找。有谁知道最近在 sphinx 中可能发生了什么变化来创建这种行为?

-- 更新--

无论它在模板中的位置如何,{{ toctree() }} 调用都不会产生任何输出,因此"侧边栏"位似乎并不重要。


好的,不知道为什么,但这解决了它:

1
2
3
  {%- block sidebartoc %}
  {{ toctree(includehidden=True) }}
  {%- endblock %}

将把它留在那里,让其他人在升级后遇到问题...