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

Question

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

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

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

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

-- 更新--

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

Answer 1

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

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

对于升级后遇到问题的任何其他人，将只保留它...

Sphinx toctree directive stopped working after update