python - 狮身人面像文档 : define but hide heading/title text

Question

我正在使用 Sphinx 来记录 Python 包。标题页/启动页的顶部包含带有项目 Logo 和文本的图形。这给出了我想要的视觉外观，但是因为我没有定义页面的顶级标题 title元数据(在浏览器选项卡中呈现)设置为 <no title> — my project name .

有没有办法可以执行以下操作之一？

1. 定义标题文本但不将其呈现为页面上的标题？
2. 设置title其他方式的页面元数据？

Answer 1

您可以自定义主题，覆盖包含 <title> 的部分标签。参见 Templating在 Sphinx 文档中获取完整信息。如果您有“基本”主题，则需要覆盖 line 130 in layout.html

    <title>{{ title|striptags|e }}{{ titlesuffix }}</title>

您可以使用 Jinja2 templating language 在主题中应用控制结构，以防您只想将此功能应用于一个页面而不是其他页面。