Sphinx toctree指令在更新后停止工作。

Question

我经常生成的sphinx HTML文档在从fedora 20更新到21后突然停止显示toctree。模板仍然没有变化，并且包含了以下内容

<div class="sidebar">
      {%- block sidebartoc %}
      {{ toctree() }}
      {%- endblock %}

曾经创建了一个toctree，但现在在生成的div中看不到TOC的证据。

没有给出警告或错误，所以我真的不知道该从哪里开始找。有谁知道sphinx最近发生了什么变化导致了这种行为？

-- 更新

不管它在模板中的位置如何，{{ toctree() }} 调用都不会产生任何输出，所以 "sidebar "位似乎并不重要。

Answer 1

好吧，不知道为什么，但这个可以解决。

<div class="sidebar">
  {%- block sidebartoc %}
  {{ toctree(includehidden=True) }}
  {%- endblock %}

就把这个留在那里，供其他升级后遇到问题的人使用... ...