Sphinx 文档包中 LaTeX 输出的自定义颜色

Question

我正在尝试在使用 Sphinx 文档包和 html 输出时自定义 LaTeX 内联公式的颜色。

详情：

我有一个名为func.rst 的文件，其中包括以下行：

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

在我使用 Sphinx 创建的文档中成功渲染到 LaTeX 中。

（我在extensions 在conf.py 中列出了'sphinx.ext.imgmath'）

我的目标是将x_{1} 涂成红色。

我尝试过的事情：

1. 在公式中添加颜色：

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

   同时也定义了

   latex_elements['preamble'] = '\usepackage{xcolor}'
   

   在conf.py 文件中。

2. 尝试使用以下方法全局定义所有数学输出：

   latex_elements['preamble'] = r'''
   \usepackage{xcolor}
   \everymath{\color{red}}
   \everydisplay{\color{red}}
   '''
   

不用说，这两个（以及许多不太有希望的想法）都失败了。

Answer 1

在tex.sx 的交叉发布问题上复制我的answer：

由于您似乎将 html 的数学渲染为 PNG 图像（或 SVG），因此当前要配置的配置值不是 latex_elements，而是 imgmath_latex_preamble。

从那以后我进行了测试，它可以工作。

Answer 2

为了完整起见，我在这里添加完整的解决方案。 （感谢 jfbu！）

1. 在conf.py我定义了extensions = ['sphinx.ext.imgmath', <some_more_unrelated_stuff>]

2. 也在conf.py我定义了

   imgmath_latex_preamble=r'\usepackage{xcolor}'
   

   （编辑：与我之前写的一样，不需要另外定义imgmath_latex="/usr/local/texlive/2017/bin/x86_64-darwin/latex"再次感谢jfbu）

3. 在我有乳胶表达式的.rst 文件中，我有

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

4. 在我运行的终端中

   make clean html
   

   （“make clean”是斯芬克斯最好的朋友）

它的工作原理！哇哦！