部署Mathjax

发表于 更新于 阅读次数： 本文字数： 1.5k 阅读时长 ≈ 1 分钟

关于Mathjax

介绍

Mathjax是一种方便的数学公式渲染工具，能接受多种输入和输出要求：

  • 输入
    • ASCIIMath
    • MathML
    • TeX(在Markdown中所用)
  • 输出
    • CommonHTML(默认)
    • HTML-CSS
    • NativeMML
    • PlainSource
    • PreviewHTML(快速预览)
    • SVG

CDN服务器将要关闭

Mathjax推荐通过cdn.mathjax.org使用，但由于经费问题，CDN服务器将于4月30日关闭。当我得到这条消息时，又想起了曾经被否定的计划。

部署Mathjax

转移

官方推荐2种方法来转移：

本地部署步骤

  1. 下载Mathjax，可以为release或git版本，我使用Mathjax-2.7，也可以使用git版本。
  2. 解压文件到网站的一个易于访问的位置，可以直接通过相对路径表示。
  3. 删除不必要的文件，整个版本有~60MiB，上万个文件。

精简过程

可以直接下载我的版本：https://github.com/zhzh2001/zhzh2001.github.io/tree/master/mathjax

  1. 删除/config下多余的配置文件。

    我保留了Tex-MML-AM_CHTML.js，表示支持Tex，MathML和ASCIIMath输入，CommonHTML输出，也是官方推荐的选项。

  2. 删除/docs，/test和/unpacked，包含Mathjax的文档及用于测试的文件。

  3. 保留/fonts/HTML-CSS下的一种字体，并只保留这种字体的woff版本。

    我保留了Tex，是最小的字体。

  4. 保留/localization下的一种语言或全部删除(使用默认的英语)。

  5. 删除/jax/output下不必要的输出格式，如果保留SVG则可以删除整个/font目录。

    我保留了CommonHTML。

自定义弹出菜单

删除部分文件后，如果不删除有关的菜单，可能使用户不小心选错而无法使用Mathjax。

  1. 打开保留的配置文件，如/config/Tex-MML-AM_CHTML.js。

  2. 删除Mathjax.Ajax.Preloading下不存在的脚本(可选)。

  3. 推荐：删除Mathjax.Hub.Config下的{extensions: ['[Contrib]/a11y/accessibility-menu.js']}。

    因为该脚本需要从[Contrib]加载，当前指向cdn.mathjax.org

  4. 在Mathjax.Hub.Config下加入

1
2
3
4
5
MathMenu: {
   delay: 0,	//可以随意设置
   showRenderer: false,	//不显示渲染器
   showLocale: false	//不显示语言
}
  1. 推荐：关闭快速预览，在Mathjax.Hub.Config下加入
1
2
3
"fast-preview": {
  disabled: true	//禁用快速预览
}
  1. 推荐：加入标准Markdown的$公式，而不是Latex的$$
1
tex2jax: {inlineMath: [['$','$'], ['\\(','\\)']]}

目前Mathjax已更新到2.7.1，可以选择升级。