theme sidebar configuration

23 views
Skip to first unread message

bradley...@gmail.com

unread,
Aug 21, 2022, 1:00:08 AMAug 21
to sphinx-users
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

unread,
Aug 21, 2022, 3:44:43 PMAug 21
to sphinx-users
The sphinx_book_theme supports this.

bradley...@gmail.com

unread,
Aug 22, 2022, 10:46:07 AMAug 22
to sphinx-users
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

But I did find it in

bradley...@gmail.com

unread,
Aug 22, 2022, 1:37:28 PMAug 22
to sphinx-users
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:
Reply all
Reply to author
Forward
0 new messages