themes - Furo Sphinx 主题在 API 文档中一直大写太多

Question

我面临着这个问题中讨论的同样问题：Furo Sphinx theme uppercases too much in API documentation。但是，接受的解决方案不起作用，似乎 Furo 模板以某种方式覆盖了custom.css：

我很感激在Furo Sphinx 主题中实现这个简单的自定义的任何帮助。

Answer 1

注意：该问题已在 Furo 2022.1.2 中修复。

---

好吧，尽管上一个问题只有两周多一点的时间，但从那时起已经有五个新版本的 Furo。我假设您使用的是最新版本，即撰写本文时的 2021.11.23。

上一个答案的解决方法实际上不再有效。这是因为 Furo 在这个 commit中使 CSS 选择器更加具体，这意味着它优先于自定义样式定义的不太具体的选择器。

因此custom.css需要更多的魅力：

dl.py .field-list dt {
    text-transform: none !important;
}

这一直只是一种解决方法，不一定是最好的。还应该有一种只选择参数和类型的方法，但保持“PARAMETERS”标题不变。

然而，这个问题最好由 Furo 的作者解决。我之前在这里报告过，但还没有收到回复。正如我在那里指出的那样，您的另一个选择是使用Napoleon而不是Numpydoc呈现您的 NumPy 样式的文档字符串。它们在页面上看起来会有所不同，但大小写问题将消失。