Hi,

Firstly, thanks for an absolutely fantastic library! Sphinx is proving 
tremendously useful.

I was wondering if it's possible to include a Caption when using 
autosummary. I'm using the ReadTheDocs theme. Currently my index.rst looks 
a bit like this:

Group1
======

.. autosummary::
   :toctree: _autosummary

   package1
   package2


Group2
======

.. autosummary::
   :toctree: _autosummary

   package3
   package4


I wish to separate Group1 and Group2 in the navigation sidebar. I believe 
it's the "caption" TOC option. For example, as shown in this example 
<https://sphinx-rtd-theme.readthedocs.io/en/stable/>: "THEME DOCUMENTATION" 
and "DEMO DOCUMENTS" are nicely separated. 

But this doesn't seem to be accepted when using autosummary. The code below 
fails. Any ideas?

Group1
======


.. autosummary::
   :toctree: _autosummary
   :caption: Group 1

   package1
   package2



Group2
======


.. autosummary::
   :toctree: _autosummary
   :caption: Group 2

   package3
   package4

Any advice greatly appreciated!

-- 
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 [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/47bf65f3-a986-484f-a78d-c5a61c75722c%40googlegroups.com.

Reply via email to