如何在 Sphinx 中添加横幅区域？

Question

我正在使用 Sphinx to document my open source project。我想在导航栏上方添加一个区域，其中包含指向 GitHub 上的项目、我的项目主页等的链接。Sphinx 主页在 "Home"、"Get It", "Docs", "Extend/Develop".

conf.py 文件有很多选项，还有主题、模板等等。看起来应该很简单，但是我没有看到。

Answer 1

我克隆了 Sphinx project on GitHub 来寻找答案。

如果扩展主题，可以添加指向 layout.xml 文件的链接。 Sphinx 文档有这个：

{% block header %}
<div class="pageheader">
  <ul>
    <li><a href="{{ pathto('index') }}">Home</a></li>
    <li><a href="{{ pathto('install') }}">Get it</a></li>
    <li><a href="{{ pathto('contents') }}">Docs</a></li>
    <li><a href="{{ pathto('develop') }}">Extend/Develop</a></li>
  </ul>
  <div>
    <a href="{{ pathto('index') }}">
      <img src="{{ pathto('_static/sphinxheader.png', 1) }}" alt="SPHINX" />
    </a>
  </div>
</div>
{% endblock %}

如何在 Sphinx 中添加横幅区域？

How do I add a banner area in Sphinx?

python-sphinx