Furo Sphinx主题API文档过度大写，custom.css修改被覆盖如何解决

解决步骤 #

1. 配置CSS加载规则

在Sphinx项目的conf.py文件中添加如下配置，保证自定义样式文件加载顺序晚于Furo默认样式：

html_static_path = ['_static']
html_css_files = [
    'custom.css',
]

2. 编写高优先级自定义样式

在_static目录下新建custom.css文件，添加如下规则：

dt.sig-object {
    text-transform: none !important;
}
/* 可按需指定仅针对特定编程语言的API生效 */
dt.sig-object.py.class,
dt.sig-object.py.function,
dt.sig-object.py.method {
    text-transform: none !important;
}

!important标识会强制浏览器优先应用该规则，避免被Furo自带的样式覆盖。

3. 验证生效

重新执行Sphinx构建命令生成文档，打开HTML页面后用浏览器开发者工具检查API标题元素的样式，确认自定义规则没有被划掉即生效。

内容的提问来源于stack exchange，提问作者Paulo Araujo