使用 sphinx 和 scipy 主题的函数格式偏移

Function formatting offset with sphinx and scipy theme

我正在使用 scipy 主题和带有 autodoc + autosummary 的 sphinx。当我构建我的文档时,我在参数描述旁边得到了灰色框区域。

相反,我希望它看起来像示例,其中他们在单词 Parameter 中使用灰色框。

知道这个设置发生在哪里吗?

我正在构建 Ubuntu 18(通过 wsl2)和 windows 10。同样的事情发生了。使用 Sphinx 2.4.4

供参考,默认主题如下:

经过更多测试,我还发现 linux 和 windows 给出了不同的不同结果(只是略有不同),所以我开始比较 html 输出,发现细微差别:

<dl class="field-list"> 对比参数部分上方的 <dl class="field-list simple">。这导致我遇到了一些 github 问题。

最后问题的答案是sphinx 2改成了html5,基于这个问题:https://github.com/sphinx-doc/sphinx/issues/6472

通过将 html4_writer = True 添加到 config.py 文件,格式设置有效。