Sphinx 模板化

Question

我正在使用Sphinx。我想给它做个模板。看完文档后，我在我的conf.py文件里尝试加了一行，

templates_path = ['_templates']

然后我创建了一个文件

_templates/page.html

但是这并没有覆盖Sphinx提供的默认模板。我还需要做些什么？这个模板应该放在哪里呢？

---

编辑：

根据评论的目录结构：

conf.py
abc.txt
def.txt
makefile
_templates\
   page.html

Answer 1

这个方法对我有效。也许你需要用命令 sphinx-build -a 强制重新生成所有文件？Sphinx 只会编译它检测到有变化的 HTML 文件。另一种方法是用 touch *.rst 命令更新你所有的源文件。

Answer 2

文档中提到，系统正在寻找的模板文件是 layout.html。

也许你应该使用这个名字。

Answer 3

确保你在模板中使用主题名称作为明确的目录。例如：

{% extends "basic/layout.html" %}

可以参考：HTML主题支持