本来是为了解决实验室内部 Wiki（基于MoinMoin 引擎）的数学公式支持问题，在 MoinMoin 官方 Wiki 上看到了基于 ASCIIMathML.js 的解决方案，感觉这种方案要比使用 TeX 引擎更好一些[1]。当然，缺点也不是没有，最大的问题可能是这种方案需要网页的浏览者安装一些字体或软件。不过，由于网络上创造内容的人通常是无偿的劳动，如果浏览者觉得能够从所读内容中有所收获，他们也不至于懒到无动于衷的地步。所以，基于 ASCIIMathML.js 的数学公式支持所能带来的好处应当远大于它的缺点。

下面我根据实验室内部 Wiki 的解决方案，谈一下让 is-programmer 博客通过 ASSCIIMathML.js 获得数学公式支持的方法，希望对 is-programmer 博客的其他用户有所帮助。

部署 ASCIIMathML.js

首先，请下载 ASCIIMathML.js，然后为其打上下面的补丁：

--- /home/garfileo/Desktop/ASCIIMathML.js       2011-05-11 14:42:44.000000000 +0800
+++ ASCIIMathML.js      2011-05-11 14:42:31.000000000 +0800
@@ -44,7 +44,7 @@
 var notifyIfNoMathML = true;   // display note at top if no MathML capability
 var alertIfNoMathML = false;   // show alert box if no MathML capability
 var translateOnLoad = true;    // set to false to do call translators from js 
-var translateLaTeX = true; // false to preserve $..$, ..
+var translateLaTeX = false; // false to preserve $..$, ..
 var translateLaTeXformatting = true; // false to preserve \emph,\begin{},\end{}
 var translateASCIIMath = true; // false to preserve `..`
 var translateASCIIsvg = true;  // false to preserve agraph.., \begin{graph}..
@@ -52,7 +52,7 @@
 var displaystyle = true;      // puts limits above and below large operators
 var showasciiformulaonhover = true; // helps students learn ASCIIMath
 var decimalsign = ".";        // change to "," if you like, beware of `(1,2)`!
-var AMdelimiter1 = "`", AMescape1 = "\\\\`"; // can use other characters
+var AMdelimiter1 = "\$\$", AMescape1 = "\\\\$\\\\$"; // can use other characters
 var AMdocumentId = "wikitext" // PmWiki element containing math (default=body)
 var checkforprocessasciimathinmoodle = false; // true for systems like Moodle
 var dsvglocation = ""; // path to d.svg (blank if same as ASCIIMathML.js loc)

这个补丁对原文件作了两处修改：

• 关闭了 LaTeX 公式的识别功能，也就是让 ASCIIMathML.js 不要对 $  公式标记  $这样的代码太敏感。如果不关闭这一功能的话，那么你在文档中书写带有 Bash 之类的 Shell 提示符的代码的时候，就要多加小心，提防它们会被 ASCIIMathML.js 误认为数学公式。
• 将默认的反引号格式的 `公式标记` 换成了俩美元的  $$ 公式标记 $$ 。之所以如此，是因为我们在 Bash 命令中也经常要用到反引号的，例如 `pkg-config --cflags --libs glib-2.0`。

将修改后的 ASCIIMathML.js 文件上传至 is-programmer 个人 blog 的文件空间。如果你在 is-programmer 的用户名为 xxx，那么你的文件空间即为： http://xxx.is-programmer.com/admin/files

然后，在 blog 的后台管理界面中进入“插件/自定义页面 Header 与 Footer”页面，按下图这样设置和填写。

友情提示：不要忘记将上面图中所示代码中的“xxx”替换为你在 is-programmer 的用户名！

数学公式的书写及显示

当完成 ASCIIMathML.js 的部署之后，就可以在写日志之时即可使用 ASCIIMathML 语法书写数学公式了，例如：

你可能需要修改一下 CSS

is-programmer 有些主题的 CSS 中定义了全局样式，例如：

* {margin:0; padding:0;}

这种样式会导致一些数学公式在显示上不太和鞋，所以你需要前往 blog 的后台管理界面的“插件/自定义 CSS”页面，在 CSS 代码框中添加：

math * {margin:0.2em;padding:0.05em}

具体的 margin 与 padding 度量请根据自己的观感而定。

参考文档

[1] 基于MoinMoin+ConTeXt实现包含数学内容的Wiki网站

• 相关文章
• 全局相关文章