[sphinx-users] Re: theme sidebar configuration

[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
6008doc

sphinx_rtd_theme
du -s doc
2324doc

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:

> The sphinx_book_theme 
>  supports this.
>
> On Saturday, August 20, 2022 at 10:00:08 PM UTC-7 bradley...@gmail.com 
> wrote:
>
>> 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 ?
>>
>>

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/bd689062-5091-4650-b9de-1f999e069b8an%40googlegroups.com.

[sphinx-users] Re: theme sidebar configuration

[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

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

> The sphinx_book_theme 
>  supports this.
>
> On Saturday, August 20, 2022 at 10:00:08 PM UTC-7 bradley...@gmail.com 
> wrote:
>
>> 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 ?
>>
>>

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/24de0a0e-a91e-406e-a2e4-87dca6e3268dn%40googlegroups.com.

[sphinx-users] Re: theme sidebar configuration

[Max Lange]

The sphinx_book_theme  
supports this.

On Saturday, August 20, 2022 at 10:00:08 PM UTC-7 bradley...@gmail.com 
wrote:

> 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 ?
>
>

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/5e6e2dc9-7f0d-4670-9281-a71f57a94e7cn%40googlegroups.com.