MathJax的基本使用

MathJax是一个开放源代码的JAVAScript显示引擎，适用于所有现代浏览器中的LaTeX、MathML和AsciMath表示法。

MathJax官网为 https://www.mathjax.org 其开源文档地址为 https://github.com/mathjax

Mathjax使用基于网络字体来生成高质量的排版，这种排版可以达到完全分辨率，数学是基于文本的，而不是基于图像的，因此它可以用于搜索引擎，参考下图的微分方程，过去我们只能把公式做成图片，现在可以用LaTex文字实现。LaTex主要用于排版里。

（1）引入Mathjax

因为MathJax是基于网络字体生成公式，其内带字体比较大，所以，通常推荐使用CDN网络分发进行加载。国外用户基本上使用Jsdelivr

<script id="MathJax-script" <strong>async</strong> src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>

　　如果是国内用户推荐使用Bootcdn

<script   id="MathJax-script" async src="https://cdn.bootcss.com/mathjax/3.0.5/es5/
tex-mml-chtml.js"></script>

　如果你想从本地加载，开源下载一个Release版本。

https://github.com/mathjax/MathJax/archive/master.zip

　　如果你想本地调试器源代码，可以下载Source Code

https://github.com/mathjax/MathJax-src/archive/master.zip

在上面代码里，script里使用了async用于异步加载。id默认为MathJax-script。

（2）加载Mathjax不同的模块

Mathjax 3.0版本和2.0版本差距非常大，3.0版本开始采用模块化开发，在2.0版本里你需要加载所有的JS，但是在3.0版本里，你可以按需加载。

3.0里包含了一些核心组件组件，这些组件是Mathjax运行所必须的，除此以外，你可以按需加载你所需要的模块，

例如如果你是制作数学公式可以只加载数学模块， 你是制作文本排版的可以只加载排版模块。

基本上Mathjax默认包含了8个加载模块。

tex-chtml

tex-chtml-full

tex-svg

tex-svg-full

tex-mml-chtml

tex-mml-svg

mml-chtml

mml-svg

　它们都至少包括一个输入input处理器、一个输出output处理器、MathJaxTex所需要的字体、上下文菜单和启动模块。

tex-chtml 会加载 ams, newcommand, require, autoload, configmacros, 和 noundefined。这意味着大部分情况下能满足你基本需求。你也可以使用 require 自己加载更多模块。

tex-chtml-full 会包含tex-chtml的内容，同时还包括input/tex-full 等但是不包含 physics 和 colorV2

tex-svg mathjax默认以字体输出公式，如果你需要是svg输出公式，请使用svg包。

tex-svg-full：包含全部以svg输出格式。

tex-mml-chtml（常用）：包含了对MathML 语言的支持，显示时以字体方式显示。

tex-mml-svg：包含了对MathML 语言的支持，显示时以svg方式显示。

mml-chtml 不包含Tex，支持MathML，以文字显示。mml-svg：不包含Tex，以SVG方式显示。

（3）输入组件

目前MathJax支持三种输入组件：

input/tex

input/mathml

input/asciimath

tex：支持tex和Latex输入

mathml：支持math ml输入。

asciimath：支持 asciimath 输入

（4）理解输入和输出

现在，引入mathjax，然后写一段HTML代码

打开浏览器看到效果如下

如何理解输出是文本还是SVG？

从用户的角度看，基本上一样的，但是在浏览器渲染方面则采用不同的渲染模式。

下图显示以文本输出数学公式，此时，Mathjax自定义了很多HTML5的自定义标签 如 <mjx-mo>, <mjx-num>,。

在HTML5里出了我们常用的 div, span, a, h1 等标签外，还允许开发人员自定义浏览器标签，但是自定义标签按照约定必须以“-”分割，例如，你也可以自定义标签：<abc-xx></abc-xx>，但是不推荐用 <abcxx></abcxx>，这主要是为了方便浏览器解析，防止和现有的标签冲突等。

Mathjax通过自定义标签，然后给标签设置class属性，利用字体显示字符，所以你看到“b”不是字母“b”，而是一个矢量图形。

Mathjax为每个字符制作了一个字体，这样利用字体显示公式，字体美观，即使再放大也不失真。

在公式上，选择SVG输出。

则系统用svg显示公式。此时，如果查看浏览器的HTML代码，则如下图SVG方式。

（5）配置Mathjax

默认情况下，MathJax 使用 ( 和 ) 作为行内公式的开始和结束（类似 span）。 使用

[和] 作为段落的开始和结束（类似 div）

但是，你也可以自定义配置，如下使用 和和作为公式的开始和结束。

但是，不推荐使用是因为，是因为，是美元符号，这会导致 “这个苹果5元，那个苹果5元，那个苹果6元”,结果系统把$之间的内容当成了公式了。

请注意：和其它系统不同，对于Mathjax的配置，是直接定义一个MathJax对象，然后设置其属性。

<script>

MathJax = {

  tex: {

    inlineMath: [['$', '$'], ['\(', '\)']]

  }

};

</script>

<script id="MathJax-script" async

  src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js">

</script>

　　

（6）一些重要配置

MathJax提供了非常强大的配置参数。下面是一些配置。

MathJax = {

  options: {

    skipHtmlTags: [            //  HTML tags that won't be searched for math

        'script', 'noscript', 'style', 'textarea', 'pre',

        'code', 'annotation', 'annotation-xml'

    ],

    includeHtmlTags: {         //  HTML tags that can Appear within math

        br: 'n', wbr: '', '#comment': ''

    },

    ignoreHtmlClass: 'tex2jax_ignore',    //  class that marks tags not to search

    processHtmlClass: 'tex2jax_process',  //  class that marks tags that should be searched

    compileError: function (doc, math, err) {doc.compileError(math, err)},

    typesetError: function (doc, math, err) {doc.typesetError(math, err)},

    renderActions: {...}

  }

};

skipHtmlTags配置可以让Mathjax忽略一些标签，例如当你用 <code> 包含一些公式时，可能希望MaxJax不把其中的公式进行解析。

includeHtmlTags 可以配置在数学公式里可以出现哪些标签，例如公式里出现 n可用于换行等。

ignoreHtmlClass：可以设置忽略一些class

processHtmlClass：可以设置处理class。

我们提供了一个demo。http://demo.dotnetcms.org/math/math/

在这个demo里，插入数学公式时使用了如下配置：

let className = 'math-tex';
 
MathJax = {
  options: {
    processHtmlClass: className,
    ignoreHtmlClass: '.*'
  }
};

　　也就是只处理 class为 math-tex 的标签。