在 GitHub 页面上使用 Jekyll 不显示 MathJax 方程编号

Question

这是我的mathjax.html：

<script type="text/x-mathjax-config">
  MathJax.Hub.Config({
    extensions: ["tex2jax.js","TeX/AMSmath.js","TeX/AMSsymbols.js"],
    jax: ["input/TeX","output/HTML-CSS"],
    tex: {
      equationNumbers: { autoNumber: "AMS" },
      tagSide: "right"
    },
    tex2jax: {
      inlineMath: [ ['$','$'], ["\\(","\\)"] ],
      displayMath: [ ['$$','$$'], ["\\[","\\]"] ],
      processEscapes: true
    }
  });
</script>
<script type="text/javascript"
  charset="utf-8"
  src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>

它被包含在head.html 文件夹中的_includes\ 中

{% include mathjax.html %}

这又在default.html 文件夹中的default.html 中引用

{%- include head.html -%}

当我随后在通过 GitHub Pages 部署的 Jekyll 网站上的 Markdown 文档中使用 \label{eq:xyz} 和 \ref{eq:xyz} 或 \eqref{eq:xyz} 时，

• 方程没有编号
• 公式引用显示为“(???)”

例子：

$$ \label{eq:MSE}\tag{1}
\mathrm{MSE}(\hat{\theta}) = \mathrm{Var}(\hat{\theta}) - \mathrm{Bias}(\hat{\theta},\theta)^2
$$
(...)
\eqref{eq:MSE}

我尝试了几乎所有可以在 Internet 上找到的 MathJax 配置，但无济于事。我让它工作的唯一方法是在每个方程的标签之后添加\tag{1}、\tag{2}、\tag{3}、...，即使这样，使用\begin{split} ... \end{split} 的方程仍然没有编号。谁能告诉我怎么回事？

Answer 1

对于autoNumber: "AMS"，只有某些方程式环境会自动编号。特别是，由$$...$$ 分隔的数学不会自动编号；为此，您需要使用\begin{equation}...\end{equation}（或其他编号的对齐环境之一）。因此，使用\tag{} 是获取使用$$...$$ 的方程的方程编号的唯一方法。

如果您希望对双美元分隔的显示方程进行编号，请使用autoNumber: 'all'。这将使每个显示的方程都有一个编号，而不仅仅是 AMS 编号的环境。

还要注意split 环境不提供等式编号；它用于在外部编号的环境中使用。

---

编辑：原来你的问题是 TeX 配置块的大小写。它应该是 TeX: 而不是 tex: （在版本 2 中，这是您正在使用的），因此 TeX 输入 jax 没有找到您的 TeX 配置，因此没有被使用。这是一个工作示例：

<script type="text/x-mathjax-config">
  MathJax.Hub.Config({
    TeX: {
      equationNumbers: { autoNumber: "AMS" },
      tagSide: "right"
    },
    tex2jax: {
      inlineMath: [ ['$','$'], ["\\(","\\)"] ],
      displayMath: [ ['$$','$$'], ["\\[","\\]"] ],
      processEscapes: true
    }
  });
  MathJax.Hub.Register.StartupHook("TeX AMSmath Ready", function () {
    MathJax.InputJax.TeX.Stack.Item.AMSarray.Augment({
      clearTag() {
        if (!this.global.notags) {
          this.super(arguments).clearTag.call(this);
        }
      }
    });
  });
</script>
<script type="text/javascript" charset="utf-8"
  src="https://cdn.jsdelivr.net/npm/mathjax@2/MathJax.js?config=TeX-AMS_CHTML">
</script>

<p>
\begin{equation}
\label{eq:square}
\begin{split}
   (x+1)^2 &= (x+1)(x+1)\\
           &= x^2 + 2x + 1
\end{split}
\end{equation}
</p>

<p>
Link to equation \eqref{eq:square}
</p>

我还将 CDN 更改为不是已停用的 cdn.mathjax.org，并将配置文件更改为仅加载 TeX（不是 MathML）并使用 CommonHTML 输出而不是较旧（且速度较慢）的 HTML-CSS输出。最后，我删除了不需要的配置部分（extensions 和 jax 数组，因为它们已经包含在组合配置文件 TeX-AMS_CHTML 中。