MathJax：无法使用 Jekyll 呈现 \begin{cases}…\end{cases}

Question

我们在 our course website 上使用 MathJax，它在 Jekyll 中实现并托管在 GitHub 页面上。对于小而简单的方程式，MathJax 效果很好，但我从来没有能够让稍微复杂一点的方程式起作用。我花了很多时间调查和试验，所以我想我终于要在这里问了。

例如，以下无法呈现：

$$
S_{i} =
\begin{cases}
    X_{1} & \text{if i = 1}\
    \alpha \cdot X_{i} + (1 - \alpha) \cdot S_{i-1} & \text{if i $>$ 1}
\end{cases}
$$

Web 浏览器中呈现的输出完全是空白。

当我查看呈现的 html 时，我看到：

<p>
<span class="MathJax_Preview" style="color: inherit; display: none;"></span>
<span id="MathJax-Element-5-Frame" class="mjx-chtml MathJax_CHTML" tabindex="0" data-mathml="
    <math
        xmlns=&quot;http://www.w3.org/1998/Math/MathML&quot; />" role="presentation" style="font-size: 113%; position: relative;">
        <span id="MJXc-Node-149" class="mjx-math" aria-hidden="true">
            <span id="MJXc-Node-150" class="mjx-mrow"></span>
        </span>
        <span class="MJX_Assistive_MathML" role="presentation">
            <math
                xmlns="http://www.w3.org/1998/Math/MathML">
            </math>
        </span>
    </span>
    <script type="math/tex" id="MathJax-Element-5">% 
        <![CDATA[ S_{i} = \begin{cases} X_{1} & \text{if i = 1}\ \alpha \cdot X_{i} + (1 - \alpha) \cdot S_{i-1} & \text{if i $>$ 1} \end{cases} %]]>
    </script>
</p>

我不是 LaTeX 专家，所以我经常在 https://www.codecogs.com/latex/eqneditor.php 或 OverLeaf 等在线编辑器中编写方程式（或至少检查它们）。他们在那里表现得很好。

我首先 (link) 在 tex StackExchange 上问过这个问题，但他们说这是题外话。

更新： 我最后在 MathJax 用户组 (link) and received a working solution, which is described in detail on GitHub 上问了这个问题。感谢大家的回复！

Answer 1

看起来 Jekyll 将数学作为 MathJax <script> 标签 (<script type="math/tex">) 插入，并且该标签的内容是 TeX 表达式。不幸的是，该插件正在插入一些额外的文本以将内容标记为 CDATA。这在 HTML 中不需要，但可能用于 XHTML。你的页面是XHTML吗（我不知道Jekyll生产的是什么）？

无论如何，插件很可能是最初插入的

<script type="math/tex">
% <![CDATA[
... your expression...
% ]]>
</script>

那会起作用（即使它是不必要的），因为 TeX 中的 % 标记注释，所以 <![CDATA[ 将被忽略，结束的 ]]>.

除了 GitHub 页删除了换行符，所以你得到了

<script type="math/tex">% <![CDATA[... your expression...% ]]></script>

全部在一条线上。这意味着第一个 % 使整个表达式的其余部分成为注释，并且数学被有效地注释掉了。这意味着您没有输出，因为数学表达式实际上是空的。

这个以前出现过，我提供了a work-around 对于版本 2：

<script type="text/x-mathjax-config">
MathJax.Hub.Register.StartupHook('TeX Jax Ready', function () {
  MathJax.InputJax.TeX.prefilterHooks.Add(function (data) {
    data.math = data.math.replace(/^% <!\[CDATA\[/, '').replace(/%\]\]>$/, '');
  });
});
</script>

还有版本 3：

<script>
MathJax = {
  startup: {
    ready: function() {
      var HTMLDomStrings = MathJax._.handlers.html.HTMLDomStrings.HTMLDomStrings;
      var handleTag = HTMLDomStrings.prototype.handleTag;
      HTMLDomStrings.prototype.handleTag = function (node, ignore) {
        if (this.adaptor.kind(node) === '#comment') {
          var text = this.adaptor.textContent(node);
          if (text.match(/^\[CDATA\[(?:\n|.)*\]\]$/)) {
            this.string += '<!'
            this.extendString(node, text);
            this.string += '>';
            return this.adaptor.next(node);
          }
        }
        return handleTag.call(this, node, ignore);
      }
      MathJax.startup.defaultReady();
      MathJax.startup.document.inputJax[0].preFilters.add(function (data) {
        data.math.math = data.math.math.replace(/^% <!\[CDATA\[/, '').replace(/%\]\]>$/, '');
      });
    }
  }
};
</script>

无论如何，是（可能不必要的）CDATA“注释”以及换行符的删除导致了问题。

MathJax：无法使用 Jekyll 呈现 \begin{cases}…\end{cases}

MathJax: Can't render \begin{cases}…\end{cases} using Jekyll

html

javascript

markdown

jekyll

mathjax