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

【问题标题】：Sphinx toctree directive stopped working after updateSphinx toctree 指令在更新后停止工作
【发布时间】：2015-01-09 10:33:51
【问题描述】：

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

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

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

没有给出警告或错误，所以我真的不知道从哪里开始寻找。有谁知道 sphinx 最近发生了哪些变化来创建这种行为？

-- 更新--

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

【问题讨论】：

【解决方案1】：

好的，不知道为什么，但这解决了它：

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

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

【讨论】：