Sphinx templating

Question

I am using sphinx. I want to template it. So after reading the docs, what I am trying is, in my conf.py,

I put a line like,

templates_path = ['_templates']

and I created a file

_templates/page.html

But this does not override the default template provided by sphinx. What more should I do, and where does this template need to go?

---

EDIT:

Directory structure from the comments:

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

Answer 1

The documentation http://sphinx.pocoo.org/templating.html#working-the-the-builtin-templates says that the template it's looking for is layout.html.

Perhaps you should use that name.

Answer 2

This works for me. Perhaps you need to force a rebuild for all files with the command sphinx-build -a? Sphinx only compiles HTML files that it detects as having changed. Another option is to just touch all your source files with touch *.rst.

Answer 3

Be sure you are using the theme name as an explicit directory in your template. e.g.:

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

see: HTML Theming Support