guzzle / guzzle_sphinx_theme

Sphinx theme used by Guzzle
MIT License
169 stars 60 forks source link

Sidebar table of contents with 3 levels #22

Closed arximboldi closed 5 years ago

arximboldi commented 7 years ago

Hi!

This is a beautiful theme, thanks a lot for making this easily available.

My only complaint is that it would be nice to get three levels of depth in the sidebar table of contents. At the momment, it only show sections and subsections, but it would be nice if there was a way to make subsubsections reachable from there. The read the docs theme supports this feature.

Otherwise, could you maybe hint me at how could I achieve this feature via custom layouts?

Thanks!

numrut commented 7 years ago

Hi, @arximboldi!

You should create a _template folder in your project directory, place there file globaltoc.html from Guzzle Sphinx Theme and change the maxdepth value in that file.

arximboldi commented 7 years ago

@numrut That is a good workaround! It would be nice if they were collapsable, like in the ReadTheDocs theme, but this is a good start (I could maybe achieve the later playing with the CSS)

mgeier commented 5 years ago

I've just created PR #42, which should fix this issue.