How to hide the sidebar using Sphinx RTD theme when making htmlhelp

问题

Is it possible to hide the sidebar when using Sphinx with the ReadTheDocs theme?

Extending the question a bit more, can I have it include the sidebar when issuing a command:

$ make html

and not include it issuing a command:

$ make htmlhelp

without altering code? Maybe add something in the layout.html.

回答1:

First of all, it is poor form to ask two questions in one post. Next time, create a separate question.

For your first question, I am not sure what the option collapse_navigation actually does, but its name implies that it does what you seek. The default value is False, so toggle it to True and see what happens. See other Read the Docs theme configuration options.

For your second question, there are at least two methods.

You can use the -D option of sphinx-build and override settings in your conf.py.

You can have multiple conf.py files (named as you see fit), and use the -c option to select the appropriate file for the output you want.

回答2:

In the alabaster theme, I was able to remove the TOC/sidebar by adding the following to my conf.py file:

html_theme_options = {
    # Disable showing the sidebar. Defaults to 'false'
    'nosidebar': True,
}

I tested this in the sphinx_rtd_theme and it did not work. However, I add this as an answer here as it might be helpful for others trying to remove the sidebar in other themes (as was the case for me).

回答3:

For building matlab documentation (which I believe is similar to HTMLHelp), I found that it is possible to hide the side-bar using a additional CSS:

.wy-nav-side {
  display: none;
}

.wy-nav-content-wrap {
  margin-left: 0;
}

Then in the conf.py file I added the CSS file:

html_static_path = ['_static']

html_css_files = [
    'css/matlabdoc.css',
]

This doesn't remove the side-bar, but at least it hides it. Might help.

Looking through the RTD theme, it might also be possible to remove the side-bar by changing the search.html and localtoc.html default files in conf.py by setting them with html_sidebars = {}.

来源：https://stackoverflow.com/questions/47258151/how-to-hide-the-sidebar-using-sphinx-rtd-theme-when-making-htmlhelp

标签

python

python-sphinx

read-the-docs