如何在 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`
现在侧边栏看起来像这样:
如图片中所述。我想做几件事。
- 删除侧边栏中的标题仅,但在主页中保留它。
- 添加新的 URL link,但不会像 "Indices and Tables"
那样在主页上显示
我该怎么做?
我可以为第一个问题提出一些建议。我绝不是 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',
]
}
最后看起来像这样:
我有以下 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`
现在侧边栏看起来像这样:
如图片中所述。我想做几件事。
- 删除侧边栏中的标题仅,但在主页中保留它。
- 添加新的 URL link,但不会像 "Indices and Tables" 那样在主页上显示
我该怎么做?
我可以为第一个问题提出一些建议。我绝不是 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',
]
}
最后看起来像这样: