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

Question

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

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

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

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

- 更新 -

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

Answer 1

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

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

升级后遇到问题的任何人都会把它留在那里...