Sphinx-build 生成空内容

Question

我有一个使用 sphinx-build 构建的 ReStructured text 文档项目。在我的第一个文件中，有一个在技术上是正确的（没有警告），添加到 toc，但由于某种原因 sphinx-build 从那个第一个生成一个空的 HTML。其他文件正常生成。

附上此文件，供专家参考。

 [1]: https://pastebin.com/LucB2bpC

Answer 1

原来“搜索”是 Sphinx 中的一个特殊名称。你不能命名你的第一个“搜索”。当我将其重命名为“searchtab”时，一切正常。

见https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#special-names。