狮身人面像模板

Question

我正在使用sphinx。我想模板化它。所以在阅读了文档后，我正在尝试的是，在我的conf.py中，

我画了一行，

templates_path = ['_templates']

我创建了一个文件

_templates/page.html

但这并不会覆盖sphinx提供的默认模板。我还应该做些什么，这个模板需要去哪里？

---

修改

评论中的目录结构：

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

Answer 1

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

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

请参阅：HTML Theming Support

Answer 2

文档https://www.sphinx-doc.org/en/master/templating.html#working-with-the-builtin-templates 说它正在寻找的模板是layout.html。

也许您应该使用该名称。

Answer 3

这对我有用。也许您需要使用命令sphinx-build -a强制重建所有文件？ Sphinx仅编译它检测到已更改的HTML文件。另一个选择是只使用touch *.rst触摸所有源文件。