theme sidebar configuration

[bradley...@gmail.com]

The furo theme (with its default setting) has two side bars. The left side bar contains the contents tree for the web pages. The right side bar contains the contents tree for each individual page.  This is a very nice feature because headings within a web page do not affect the overall contents tree. This facilitates moving a sub tree to a different location in the web page contents tree (in the spirit of incremental iterative development).

Are there other themes that enable one to see these two trees separately ?

[Max Lange]

The sphinx_book_theme supports this.

[bradley...@gmail.com]

Thanks for the pointer. I was able to get the desired result using

html_theme_options = {
        'show_toc_level' : 4

 }

I was not able to find documentatiton for this setting on

https://sphinx-book-theme.readthedocs.io/en/stable/customize/index.html

But I did find it in

https://github.com/executablebooks/sphinx-book-theme/blob/master/docs/conf.py

[bradley...@gmail.com]

It appears that sphinx_book_theme uses much more disk space that sphinx_rtd_theme. Here is a comparison for a project I am working on:

sphinx_book_theme

du -s doc
6008    doc

sphinx_rtd_theme

du -s doc
2324    doc

I am using gh-pages on github to display documentation and am concerned about the size of the footprint of the documentation.

On Sunday, August 21, 2022 at 12:44:43 PM UTC-7 Max Lange wrote: