如何使用 MathJax 配置 Sphinx 以使用美元符号作为数学分隔符

Question

如何将 Sphinx 配置为使用美元符号作为 MathJax 扩展的数学分隔符？

我尝试添加

mathjax_config = {
    'tex2jax': {
      'inlineMath': [ ['$','$']],
      'displayMath': [ ['$$','$$']],
    },
}

致conf.py，但这有两个问题：

1. 数学需要两个反斜杠。例如，$\\sin(x)$。似乎 Sphinx 去掉了单个反斜杠。
2. 如果我没有在页面某处包含正常的..math 指令，它不会加载 MathJax Javascript。我想专门使用$ 和$$ 来分隔数学。

Answer 1

我编写了一个 Sphinx 扩展程序，可以让你这样做https://www.sympy.org/sphinx-math-dollar/

要使用它，请安装扩展程序

pip install sphinx-math-dollar

并将其添加到您的 conf.py 中

extensions = ['sphinx_math_dollar', 'sphinx.ext.mathjax']

作为技术说明，在不使用此扩展程序的情况下尝试正确执行此操作将非常困难。您必须在 Sphinx 处理中的正确位置进行替换。如果你在处理过程中太晚了（例如，通过设置 JavaScript 配置），它就不会起作用，因为 Sphinx 已经从那时的数学中删除了所有反斜杠。如果你做得太快（例如，通过对输入文本进行正则表达式替换），它也会失败，因为你最终会在你不想要的东西中替换数学，例如在文档测试或代码中。