Table of Contents issue in API doc pages

[josephmure]

The current master has very ugly API TOCs:

https://openturns.github.io/openturns/master/user_manual/_generated/openturns.ConditionalDistribution.html

This bug was not introduced by PR #2136, as the CircleCI-compiled doc of that PR shows:

https://output.circle-artifacts.com/output/job/994fb343-d924-4b6d-9fc9-c0186f62f674/artifacts/0/html/user_manual/_generated/openturns.ConditionalDistribution.html

Did something change with Sphinx?

[jschueller]

yes, the version: 5.2.x

[josephmure]

Can you fix this before the RC or should we freeze the Sphinx version for now?

[jschueller]

at least open an issue at sphinx with the same report please

[jschueller]

looks it comes from sphinx-doc/sphinx#10807

[josephmure]

I have raised the issue in the discussion of the request that prompted the creation of the feature that is causing the problem: sphinx-doc/sphinx#6316 (comment)

[josephmure]

The option to disable the feature is implemented in PR sphinx-doc/sphinx#10886 (intended for sphinx 5.2.3). I have tested it locally: it works fine.

To disable the feature, we will need to add the following line to conf.py.in:

toc_object_entries = False

[josephmure]

We might want to think about updating the "openturns" theme, however.