Configuration html_主题_选项与使用雪花石膏的conf.py中的html_徽标

您好，所有有经验的Sphinx用户

几天以来，我第一次使用Sphinx构建了一个小型文档站点。我在玩雪花石膏主题。当我尝试在左上角放置徽标时，它仅适用于使用构建配置文件“conf.py”中的条目，如下所示：

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

html_theme_options = { 
    'logo': 'images/PJS-small.png',
    # etc.
}

当我尝试像这样使用雪花石膏主题配置时

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

侧边栏上方未显示任何徽标

我想使用主题配置，因为我可以放置字幕和其他类似的东西

有人知道如何使用雪花石膏配置吗

---

非常感谢您的帮助。

在主题配置（

theme.conf

）文件中，您需要使用以下语法：

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

请注意，徽标路径中没有

\u static

目录（它在主题的HTML模板中预先添加）和小写布尔值

尽管如此，您仍然可以通过Sphinx项目配置文件（

conf.py

）中的

html\u theme\u options

对象设置任何主题配置变量， 您必须在

conf.py

文件中添加

html\u侧栏设置：

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

这将导致加载雪花石膏的自定义侧栏模板

然后，您可以按如下方式指定徽标路径：

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

html_theme_options = { 
    'logo': 'images/PJS-small.png',
    # etc.
}

路径会自动在前面加上
\u static/