时间戳

首页 > 解决方案 > 从 MathJax 2.7.5 升级到 3.0，试图保留一个自定义的 TeX 环境

jekyll - 从 MathJax 2.7.5 升级到 3.0，试图保留一个自定义的 TeX 环境

问题描述

我在 GitHub Pages 上的 Jekyll 博客中使用 MathJax。事实上，我写了一篇博文，详细介绍了我设置 MathJax 2.7.5 所采取的步骤：“Jekyll 中的 MathJax”（2018 年 8 月）

对于几篇文章，我想使用一个psmallmatrix环境，比如mathtools包中的那个：$$\begin{psmallmatrix} 1 \\ 0 \end{psmallmatrix}$$. 我知道如何在实际的 TeX 中创建这样的环境，使用\newenvironment命令：“我如何制作一个小的 pmatrix？”

但是为了在 MathJax 2.7.5 中“预加载”命令，我正在这样做，从 MathJax 版本的 AMSmath 包中下载一些代码：

<script type="text/x-mathjax-config">
  MathJax.Hub.Config({
    extensions: [
      "MathMenu.js",
      "MathZoom.js",
      "AssistiveMML.js",
      "a11y/accessibility-menu.js"
    ],
    jax: ["input/TeX", "output/CommonHTML"],
    TeX: {
      extensions: [
        "AMSmath.js",
        "AMSsymbols.js",
        "noErrors.js",
        "noUndefined.js",
      ]
    }
  });
  MathJax.Hub.Register.StartupHook("TeX Jax Ready",function () {
    var TEX = MathJax.InputJax.TeX;
    var COLS = function (W) {
      var WW = [];
      for (var i = 0, m = W.length; i < m; i++)
        {WW[i] = TEX.Parse.prototype.Em(W[i])}
      return WW.join(" ");
    };
    TEX.Definitions.Add({
      environment: {
        psmallmatrix: ['Array',null,'(',')','c',COLS([1/3]),".2em",'S',1],
      }
    });
  });
</script>
<script type="text/javascript" async
  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js">
</script>

在过去一年左右的某个时候，MathJax 2.7.5 完全停止在 GitHub 上工作，所以我正在尝试升级到 MathJax 3.0。

我已经设法通过使用MathJax 自己的配置转换器来翻译此配置的非棘手部分，但我不知道如何处理我的手工制作的psmallmatrix. 这是我现在拥有的：

<script type="text/javascript">
window.MathJax = {
  tex: {
    packages: ['base', 'ams'],
  },
  loader: {
    load: ['ui/menu', '[tex]/ams'],
  },
};
</script>
<script type="text/javascript" id="MathJax-script" async
  src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js">
</script>

如何psmallmatrix在 MathJax 3.0 中恢复我手工制作的环境？格式只需要大致相同，只要我可以继续使用\begin{psmallmatrix}.

我应该提到，“定义 TeX 宏”上的 MathJax 文档给出了一个示例，说明如何使用宏“预加载”TeX 解析器，大致相当于\newcommand会做什么。文档说：

window.MathJax = {
  tex: {
    macros: {
      RR: "{\\bf R}",
      bold: ["{\\bf #1}", 1]
    }
  }
};

但是文档缺少任何关于如何为\newenvironment.

标签： jekyllgithub-pagesmathjaxtex

解决方案

下面是将psmallmatrix环境添加到 AMS 环境列表的配置。应该有一种预配置环境的方法，该方法类似于为宏所做的。我已经在 MathJax GitHub 存储库中对其提出了功能请求。

现在，添加

<script>
MathJax = {
  startup: {
    ready() {
      MathJax.startup.defaultReady();
      const Macro = MathJax._.input.tex.Symbol.Macro;
      const MapHandler = MathJax._.input.tex.MapHandler.MapHandler;
      const Array = MathJax._.input.tex.ams.AmsMethods.AmsMethods.Array;
      const env = new Macro('psmallmatrix', Array, [null,'(',')','c','.333em','.2em','S',1]);
      MapHandler.getMap('AMSmath-environment').add('psmallmatrix', env);
    }
  }
};
</script>

作为启用psmallmatrix环境的配置。

推荐阅读