<返回更多

MathJax的基本使用

2020-05-04    
加入收藏

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

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

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

MathJax的基本使用

 

(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代码

MathJax的基本使用

 

打开浏览器看到效果如下

MathJax的基本使用

 

 

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

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

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

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

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

 

MathJax的基本使用

 

 

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

MathJax的基本使用

 

在公式上,选择SVG输出。

MathJax的基本使用

 

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

 

MathJax的基本使用

 

 

(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 的标签。

声明:本站部分内容来自互联网,如有版权侵犯或其他问题请与我们联系,我们将立即删除或处理。
▍相关推荐
更多资讯 >>>