如何在 Sphinx Alabaster 主题下编辑侧边栏

How to edit Sidebar under Sphinx Alabaster theme

我有以下 index.rst 文件。

Know the cell population of your data
=====================================
Some content

.. toctree::
   :maxdepth: 2

Installation
~~~~~~~~~~~~
.. toctree::
   :maxdepth: 2

   installation

Scripts
~~~~~~~
.. toctree::
   :maxdepth: 2

   scripts

API documentation
~~~~~~~~~~~~~~~~~
.. toctree::
   :maxdepth: 2

   apidoc

Roadmap
~~~~~~~
.. toctree::
   :maxdepth: 2

   roadmap

Indices and Tables
==================
* :ref: `genindex`

现在侧边栏看起来像这样:

如图片中所述。我想做几件事。

  1. 删除侧边栏中的标题,但在主页中保留它。
  2. 添加新的 URL link,但不会像 "Indices and Tables"
  3. 那样在主页上显示

我该怎么做?

我可以为第一个问题提出一些建议。我绝不是 CSS 方面的专家,所以我的解决方案可能不是更优雅的解决方案,但它确实有效!放入您的 'source/_static/custom.css' 文件:

.sphinxsidebar a.reference.internal[href='#'] {
  display: none;
}

也许 CSS 专家应该给出更好的选择器……

我终于通过以下方式修复了它

在 Sphinx 的 _template 目录中创建一个文件 称为 foo.html.

内容可能是这样的:

<hr />
<p>
<h2 class='logo'>
<a href="https://foo.bar.com/">Web Version</a>
</h2>
</p>

最后在conf.py中添加:

html_sidebars = {
        '**': [
                 'localtoc.html',
                 'relations.html',
                 'searchbox.html',
                 # located at _templates/
                 'foo.html',
            ]

        }

最后看起来像这样: