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

Question

我经常生成的sphinx文档在从fedora 20更新到21之后突然停止显示一棵树。模板仍未更改，并包含

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

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

没有警告或错误，所以我真的不知道从哪里开始寻找。有没有人知道最近斯芬克斯人会改变什么来创造这种行为？

-更新

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

Answer 1

好吧，不知道为什么，但这解决了这个问题：

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

会把这个留给升级后遇到问题的其他人.