Sphinx templating

Я использую sphinx. Я хочу создать шаблон. Таким образом, после прочтения документации, что я пытаюсь, на мой conf.py,Sphinx templating

Я положил строку,

templates_path = ['_templates']

и я создал файл

_templates/page.html

Но это делает не переопределять шаблон по умолчанию, предоставляемый sphinx. Что еще мне нужно сделать, и где этот шаблон должен идти?

EDIT:

Структура каталогов из комментариев:

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

источник

2009-07-03 agiliq

Можете ли вы представить структуру каталогов, которую вы используете? –

Форматирование здесь искалечено, поэтому см. Http://gist.github.com/140207 – agiliq

@uswaretech: Я добавил его для вас на вопрос. – nosklo

Убедитесь, что вы используете имя темы в качестве явного каталога в своем шаблоне. например .:

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

см: HTML Theming Support

источник

2009-11-19 23:06:00

Документация http://sphinx.pocoo.org/templating.html#working-the-the-builtin-templates говорит, что шаблон он ищет это layout.html.

Возможно, вы должны использовать это имя.

источник

2009-07-03 13:55:31

Этот шаблон будет тем, который использовался для макета, я считаю. Это было бы необходимо, если бы я хотел изменить положение боковой панели. Но я хочу добавить что-то к телу. В шаблоне sphinx/themes/basic/есть шаблон, называемый page.html, который я хочу переопределить. – agiliq

Это работает для меня. Возможно, вам нужно принудительно восстановить все файлы с помощью команды sphinx-build -a? Sphinx только компилирует HTML-файлы, которые он обнаруживает как измененные. Другой вариант - просто коснуться всех исходных файлов с помощью touch *.rst.

источник

2009-07-11 01:53:19 hao

Sphinx templating

ответ

Смежные вопросы