Sphinx RTD 主题：更改内联代码的颜色

如何解决Sphinx RTD 主题：更改内联代码的颜色

我将 Sphinx 与 Read the Docs theme 一起使用。对于小的内联代码片段，例如在一段文本中提及单个变量，我使用双反引号将代码格式化为 documentation 中所谓的“内联文字”。

1. 这是格式化内联代码片段的正确方法吗？

与正确的代码块不同，在内联代码片段上没有执行特定于语言的语法突出显示（这很好）。正如上面链接的文档中所见（见下面的屏幕截图），所有这些“内联文字”都是红色的。

2. 如何将此颜色更改为其他颜色？

我只关心 Sphinx 的 HTML 输出。

解决方法

我找到了一个解决方案，尽管它涉及更改 Sphinx RTD 主题源代码。

RTD 主题使用的 HTML 着色在 sphinx_rtd_theme/static/css/theme.css 中指定，sphinx_rtd_theme 目录位于 Python 安装的 site-packages 目录中。使用的红色是 #e74c3c 并且为内联文字设置此颜色的具体位置是

literal{color:#e74c3c}

改变这种颜色正是我想要的。不过，直接对 theme_css 进行更改感觉是错误的。具体变化发生在第 4 行，超过 100000 个字符！显然这个文件是从其他文件生成的。我想正确的解决方案是执行这些（我不知道的）文件之一的更改。

编辑：正确的解决方案

使用自定义 .css 文件，可以使用

设置内联文字的颜色

code.literal {
    color: #404040 !important;
    background-color: #fbfbfb !important;
}

Sphinx .css 中的 html_css_files 中应添加包含上述内容的 conf.py 文件名，即

# conf.py
html_css_files = ['custom.css']