斯芬克斯模板

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

文档http://sphinx.pocoo.org/templating.html#working-the-the-builtin-templates 说，这是寻找模板是layout.html。

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

Answer 3

这适用于我。也许你需要用命令sphinx-build -a强制重建所有文件？狮身人面像只能编译它检测到已经改变的HTML文件。另一种选择是只用touch *.rst触摸所有源文件。