附录 A — `Mathjax`的离线安装与使用

附录 A 介绍了网页显示数学公式的插件mathjax，本地化安装和使用方法等. (R Core Team, 2021; Xie, 2015)

A.1 mathjax 简介

MathJax是一款相当强悍的在网页显示数学公式的插件.
基于Mathjax, 就可通过 LaTeX 的命令输出精美的数学公式. 加载Mathjax后¹，就可通过一对美元符号$(或左$右 $)输入行内公式，通过一对双美元符号$$(或左\[右\])输入行间公式，例如

$$
J\alpha(x) = \sum_{m=0}^\infty 
\frac{(-1)^m}{m! \Gamma (m + \alpha + 1)} 
{\left({ \frac{x}{2} }\right)}^{2m + \alpha}
$$

显示出下面的数学公式 \[ J\alpha(x) = \sum_{m=0}^\infty \frac{(-1)^m}{m! \Gamma (m + \alpha + 1)} {\left({ \frac{x}{2} }\right)}^{2m + \alpha}. \]

可以使用 LaTeX 自带的复杂的数学环境和数学字体命令，如排版多行公式的align 和 split环境，字母加黑命令\mathbb{}

\begin{align}
3x-1 &= \mathbb{A} \\
  3x &= \mathbf{B} \\
   x &= \mathscr{C}
\end{align}

输出为 \[\begin{align} 3x-1 &= \mathbb{A} \label{eq-A-1}\\ 3x &= \mathbf{B} \\ x &= \mathscr{C} \end{align}\]

A.2 调用远程服务器上的`mathjax`

一般情况下，只需要使用远程加载Mathjax的js库就行了，例如在需要渲染数学公式的网页上增加html命令

</script>
<script type="text/javascript" async
  src="https://cdn.mathjax.org/mathjax/latest/
  MathJax.js?config=TeX-MML-AM_CHTML">
</script>

A.3 `mathjax`本地服务器的安装与使用

我们以Macbook的Apache服务器为例说明步骤²

服务器的启动

在终端(terminal)下输入命令

sudo apachectl start

检查服务是否启动成功

在浏览器中输入网址

http://127.0.0.1/

如果显示It Works!就表示服务器已经成功启动. 请记住:服务器上文件在本地的位置为

/Library/WebServer/Documents

关闭服务器(不用时)

在终端(terminal)下输入命令

sudo apachectl stop

将Mathjax2.6或Mathjax2.7下载并解压到/Library/WebServer/Documents下³, 目录名为Mathjax
启动本地Mathjax

在运行Bookdown(或其他R Mmarkdown, Quarto Markdown 文件)时，须加载下面的由html命令组成的文件mathjax_27.html

</script>
<script type="text/javascript"
   src="http://127.0.0.1/MathJax/MathJax.js">
</script>

并在Bookdown或 Quarto Markdown中由_output.yml的命令

include-in-header: mathjax_27.html

加载进来.

需要远程或本地支持↩︎
Windows 10下的本地服务器的启动可参考(https://www.jianshu.com/p/d86c77942181)↩︎
暂且不要用最新的3.2版本↩︎

# `Mathjax`的离线安装与使用 {#sec-mjx} @sec-mjx 介绍了网页显示数学公式的插件mathjax，本地化安装和使用方法等. [@xie2015; @R-base] ## mathjax 简介 {#sec-mjx-1} - [MathJax](https://www.mathjax.org/)是一款相当强悍的在网页显示数学公式的插件. - 基于`Mathjax`, 就可通过 LaTeX 的命令输出精美的数学公式. 加载Mathjax后[^mathjax27-1]，就可通过一对美元符号`$`(或左`$`右 `$`)输入行内公式，通过一对双美元符号`$$`(或左`\[`右`\]`)输入行间公式，例如 ``` $$ J\alpha(x) = \sum_{m=0}^\infty \frac{(-1)^m}{m! \Gamma (m + \alpha + 1)} {\left({ \frac{x}{2} }\right)}^{2m + \alpha} $$ ``` 显示出下面的数学公式 $$ J\alpha(x) = \sum_{m=0}^\infty \frac{(-1)^m}{m! \Gamma (m + \alpha + 1)} {\left({ \frac{x}{2} }\right)}^{2m + \alpha}. $$ - 可以使用 LaTeX 自带的复杂的数学环境和数学字体命令，如排版多行公式的`align` 和 `split`环境，字母加黑命令`\mathbb{}` [^mathjax27-1]: 需要远程或本地支持 ``` \begin{align} 3x-1 &= \mathbb{A} \\ 3x &= \mathbf{B} \\ x &= \mathscr{C} \end{align} ``` 输出为 \begin{align} 3x-1 &= \mathbb{A} \label{eq-A-1}\\ 3x &= \mathbf{B} \\ x &= \mathscr{C} \end{align} ## 调用远程服务器上的`mathjax` {#sec-mjx-2} 一般情况下，只需要使用远程加载`Mathjax`的`js`库就行了，例如在需要渲染数学公式的网页上增加`html`命令 ``` </script> <script type="text/javascript" async src="https://cdn.mathjax.org/mathjax/latest/ MathJax.js?config=TeX-MML-AM_CHTML"> </script> ``` ## `mathjax`本地服务器的安装与使用 {#sec-mjx-3} 我们以`Macbook`的`Apache`服务器为例说明步骤[^mathjax27-2] [^mathjax27-2]: Windows 10下的本地服务器的启动可参考(https://www.jianshu.com/p/d86c77942181) 1. 服务器的启动在终端(terminal)下输入命令 ``` sudo apachectl start ``` 2. 检查服务是否启动成功在浏览器中输入网址 ``` http://127.0.0.1/ ``` 如果显示`It Works!`就表示服务器已经成功启动. 请记住:服务器上文件在本地的位置为 ``` /Library/WebServer/Documents ``` 3. 关闭服务器(不用时) 在终端(terminal)下输入命令 ``` sudo apachectl stop ``` 4. 将`Mathjax2.6`或`Mathjax2.7`下载并解压到`/Library/WebServer/Documents`下[^mathjax27-3], 目录名为`Mathjax` 5. 启动本地`Mathjax` [^mathjax27-3]: 暂且不要用最新的3.2版本在运行`Bookdown`(或其他`R Mmarkdown`, `Quarto Markdown` 文件)时，须加载下面的由`html`命令组成的文件`mathjax_27.html` ``` </script> <script type="text/javascript" src="http://127.0.0.1/MathJax/MathJax.js"> </script> ``` 并在`Bookdown`或 `Quarto Markdown`中由`_output.yml`的命令 ``` include-in-header: mathjax_27.html ``` 加载进来.

A.1 mathjax 简介

A.2 调用远程服务器上的mathjax

A.3 mathjax本地服务器的安装与使用

A.2 调用远程服务器上的`mathjax`

A.3 `mathjax`本地服务器的安装与使用