如何在Sphinx文档的HTML输出中自定义LaTeX行内公式颜色

我明白你想用Sphinx的sphinx.ext.imgmath扩展生成HTML文档时，给行内LaTeX公式x_{1}设置红色的需求，之前的两种方法没生效，大概率是因为imgmath的配置细节没处理到位——毕竟它是把LaTeX公式转换成图片输出，不是直接在HTML里渲染数学公式，得调整它的专属编译参数才行。

下面给你两个可行的解决方案，分别对应单个公式改色和全局公式改色：

方案1：给单个行内公式设置颜色 #

1. 修改func.rst里的公式内容，用LaTeX的\textcolor命令（比直接用\color更稳妥，避免意外影响后续文本）：

Let :math:`\textcolor{red}{x_{1}}` be a binary variable.

2. 在conf.py里配置imgmath的LaTeX预导言，确保加载xcolor包：

# 先确认extensions列表里已包含'sphinx.ext.imgmath'
extensions = [
    # 你的其他扩展...
    'sphinx.ext.imgmath',
]

# 配置imgmath专属的LaTeX预导言（这一步是关键！）
imgmath_latex_preamble = r'\usepackage{xcolor}'

划重点：不要用latex_elements['preamble']，这个配置是给Sphinx生成PDF文档的LaTeX模板用的，imgmath生成公式图片时是独立调用编译流程，不会读取这个配置。

方案2：全局设置所有数学公式的颜色 #

如果你想把所有行内和块级公式都统一改成红色，只需要修改conf.py里的imgmath_latex_preamble：

imgmath_latex_preamble = r'''
\usepackage{xcolor}
\everymath{\color{red}}
\everydisplay{\color{red}}
'''

这样所有通过imgmath生成的公式图片都会默认显示为红色。

为什么之前的方法没生效？ #

你之前配置的latex_elements['preamble']是给PDF输出的LaTeX模板用的，和imgmath生成公式图片的编译流程完全独立，所以无论怎么设置这个参数，都不会影响HTML里的公式图片样式。必须用imgmath专属的imgmath_latex_preamble参数，才能让颜色配置作用到公式图片上。

最后记得重新执行sphinx-build命令生成HTML，新的配置才能生效哦~

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