Sfinks Templating

Question

Używam sphinx. Chcę go szablonować. Więc po przeczytaniu docs, co usiłuję jest, moim conf.py,

umieścić taką linię,

templates_path = ['_templates'] 

i stworzyłem plik

_templates/page.html 

Ale to robi nie przesłonić domyślnego szablonu dostarczonego przez sfinksa. Co jeszcze powinienem zrobić i gdzie powinien iść ten szablon?

---

EDIT:

Struktura katalogów z uwagami:

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

Answer 1

Upewnij się, że używasz nazwy motywu jako jawnego katalogu w szablonie. np .:

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

patrz: HTML Theming Support

Answer 2

Dokumentacja http://sphinx.pocoo.org/templating.html#working-the-the-builtin-templates mówi, że szablon to szukasz jest layout.html.

Być może powinieneś użyć tego imienia.

Answer 3

To działa dla mnie. Być może musisz wymusić przebudowę wszystkich plików za pomocą komendy sphinx-build -a? Sphinx kompiluje tylko pliki HTML, które wykrył jako zmienione. Inną opcją jest po prostu dotknięcie wszystkich plików źródłowych za pomocą touch *.rst.