How to edit Sidebar under Sphinx Alabaster theme

问题

I have the following index.rst file.

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`

Now the sidebar looks like this:

As described in that image. I'd like to do couple of things.

remove the title only in the sidebar but maintaining it in the main page.
add new URL link, but not showing it in the main page like "Indices and Tables"

How can I do that?

回答1:

I finally fixed it the following way

In the Sphinx's _template directory create a file called foo.html.

The content may look something like this:

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

Finally in conf.py add this:

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

        }

At the end it looks like this:

回答2:

I can propose something for the first question. I'm in no way an expert in CSS so my solution isn't probably the more elegant one, but it works ! Put in your 'source/_static/custom.css' file :

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

Maybe a CSS expert should give a better selector …

来源：https://stackoverflow.com/questions/33029008/how-to-edit-sidebar-under-sphinx-alabaster-theme

标签

python

python-sphinx

restructuredtext