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

Question

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

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

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

2. 我怎样才能把这个颜色变成别的颜色？

我只关心 Sphinx 的 HTML 输出。

Answer 1

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

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

literal{color:#e74c3c}

改变这个颜色正是我想要的。直接做出改变theme_css虽然感觉不对。具体变化发生在第 4 行，该行超过 100000 个字符宽！显然这个文件是从其他文件生成的。我想正确的解决方案涉及执行这些（对我来说未知）文件之一的更改。

编辑：正确的解决方案

使用自定义.css文件，可以使用以下命令设置内联文字的颜色

literal{color:#e74c3c}

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

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