Hi all,
on almost every projects I am working on, after a couple of months, the
table of content becomes quite long and at times it also may result in
strange side-effects (*).
Scenario: I am using RTD theme and I simulated top-level parts by splitting
the toctree in multiple toctress composed of sections, e.g.,
.. toctree::
:maxdepth: 2
:caption: Install:
general
architecture
installation
upgrade
The full toctree is quite long and to reduce its display on the left-hand
side column, I have tried to modify the template to have each top-level
part wrapped in a dropdown, whose title is the title of the part (i.e.,
"Install") and the content the list of the sections (general, architecture,
and so on), but with no luck so far.
My questions therefore are: how do you deal with long ToC? Do you know if
there exists any sphinx-theme or other mechanism that help reducing the
length of the ToC?
I found many projects with extremely long ToC that make somehow difficult
to find the content, so I suppose that there is no answer to my question.
Thanks you in advance for your thoughts!
Stefano
(*) Using RTD theme, if you use tabs from sphinx-design extension, the Toc
"moves" when you click on the tabs. I know I need to report it, but I still
need to identify and frame the problem correctly before submitting
--
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/u2vreu%2411a1%241%40ciao.gmane.io.
