toctree caption paragraphs miss the "caption" class

[ocharles]

Problem

toctrees with captions are currently displayed as a raw <p> tag (in HTML output), without the caption class.

Reproducible Project

https://rel8.readthedocs.io/en/latest/

Note the captions on each toctree in the sidebar are too big, and lack the correct colour:

This is as-of https://github.com/circuithub/rel8/tree/6a3913b2b625724fbd67554b3cc1e3eb428f45de/docs

Expected Results

The sidebar looks more like the sidebar in the documentation for this theme:

[ocharles]

I note that the p elements also don't have caption in the default theme either, so maybe this is a Sphinx bug?

[Blendify]

From initial tests I think this is due to docutils 0.17 being installed. I am transferring the issue to the main rtd repository, docutils 0.17 should not be installed, sphinx has issues with it and I don't think it will be supported until sphinx 4.0.

[Daltz333]

Corresponding Sphinx issue sphinx-doc/sphinx#9001

The fix is just to pin the docutils dependency to 0.16.0...

in your requirements.txt (you should be using one!) add

docutils==0.16.0

[ocharles]

Thanks folks, I'll pin docutils. Thanks!

[ocharles]

Ok, adding that pin has solved the problem. Thanks again!