html_theme_options против html_logo в conf.py с помощью алебастра

Question

привет всем опытных пользователей Sphinx,

уже несколько дней я исполняющий своих первых опыты с Сфинкса для создания небольшого сайта документации. Я играю вокруг, используя тему Alabaster. Когда я пытаюсь поместить логотип в левом верхнем углу он работает только с помощью записи в файле конфигурации сборки «conf.py», как это:

html_logo = '_static/images/PJS-small.png' 

, когда я пытаюсь использовать настройки темы алебастр, как это

html_theme_options = { 
    'logo': '_static/images/PJS-small.png', 
    'logo_name': True, 
    'description': 'one more logo' 
} 

не отображается над боковой панелью.

Я хотел бы использовать конфигурацию темы, потому что я могу разместить субтитры и другие подобные вещи.

Есть ли у кого-нибудь идеи, как использовать конфигурации Alabaster, как это документировано?

Большое спасибо за помощь.

Answer 1

В конфигурации темы (theme.conf файл), вам нужно использовать следующий синтаксис:

logo = images/PJS-small.png 
logo_name = true 
description = one more logo 

Обратите внимание на отсутствие _static каталога на пути логотипа (он предваряется в шаблоне HTML Тематической), и в нижнем регистре boolean.

Тем не менее вы можете установить любую конфигурацию конфигурации темы через объект html_theme_options в файле конфигурации проекта Sphinx (conf.py).

Answer 2

Вы должны добавить параметр html_sidebars в файл conf.py:

html_sidebars = { 
    '**': [ 
     'about.html', 
     'navigation.html', 
     'relations.html', 
     'searchbox.html', 
     'donate.html', 
    ] 
} 

Эта настройка описана в конце Alabaster installation instructions.