Quarto生成EPUB文档时自定义颜色公式失效问题

问题描述 #

使用Quarto编写EPUB文档时，通过webtex方法渲染公式，标准颜色名（如red）可正常生效，但十六进制格式的自定义颜色（如#FF00FF）无法显示对应颜色。

原因分析 #

当前使用的webtex服务默认对LaTeX原生\color命令的十六进制格式支持有限，需借助LaTeX xcolor包的HTML语法来指定自定义颜色。

解决方案 #

修改公式中的颜色调用语法，用\color[HTML]{HEXCODE}替换\color{#HEXCODE}；也可提前通过\definecolor定义自定义颜色后再调用。

修改后的示例代码 #

---
format:
  epub:
    html-math-method:
      method: webtex
      url: https://latex.codecogs.com/svg.latex?
---

无颜色（正常工作）：
$e^2$

标准颜色（正常工作）：
$\color{red} s^2$

自定义颜色（修复后）：
$\color[HTML]{FF00FF} x^2 + \color[HTML]{00FF00} y^2 = \color[HTML]{0000FF} z^2$

定义颜色后使用：
$\definecolor{purple}{HTML}{FF00FF}\color{purple}x^2 + \definecolor{green}{HTML}{00FF00}\color{green}y^2 = \definecolor{blue}{HTML}{0000FF}\color{blue}z^2$

验证说明 #

该webtex服务支持xcolor包的HTML颜色语法，使用[HTML]选项后，十六进制颜色可正确渲染为对应颜色的SVG公式，嵌入EPUB后即可正常显示。

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