WpMathEditor：我的第一个WordPress插件

　　一直想重新写一下WordPress的公式编辑器插件，最近业余稍微有了点时间，于是学了一下如何写WordPress插件。之所以想重写WordPress公式编辑插件，原因有二：第一，这种插件很少，当时我有这个需要的时候，发现国内竟然没有人介绍这类插件，于是写了一篇介绍性的文章《WordPress中的公式编辑器插件》，目前的点击率表明这类插件还是有需求的；第二，在使用过程中，对于wpmathpub，我并不是很满意，尤其是它的[pmath]标签，觉得很繁琐，于是对其做了修改，写了第二篇如何修改的文章《PhpMathPublisher与wpmathpub修改》，但是这种修改事实上像是转了个圈——wpmathpub把<m>替换为[pmath]，而我又将[pmath]替换为<m>，中间过程多此一举，所以一直有修改的念头。
　　重写的时候又仔细看了下PhpMathPublisher的代码，真的是很佩服这个法国中学老师作者，可以说这个库是这几个wordpress公式编辑器插件的基石，贡献率超过90%。当然，我的这个插件WpMathEditor也不例外，甚至更依赖于PhpMathPublisher，因为我将它的<m>标签都保留了。
　　我的代码应该是最最简单的了，只有几句，写得时候的原则是能省则省，能不用就不用，包括自定义公式大小，但基本上这个插件已经能满足”我爱自然语言处理“的所有需求了。以下是规范的中文使用说明书，同时我已经将PhpMathPublisher的帮助文档译成中文，这样能作为WpMathEditor的帮助文档，我相信详细的说明文档对于大家使用这个插件将会有很好的辅助作用。

简介
　　WpMathEditor是WordPress的一个公式编辑器插件，用于文章及页面中的数学公式显示。这个插件建立在PhpMathPublisher的基础之上，通过调用它所提供的库函数，将在<m>...</m>之间的数学命令转换成数学公式，插入到文章或页面中。

使用说明
　　编辑文章或页面时请使用WordPress的HTML模式，当需要插入数学公式时，可以在文本中插入<m>数学命令</m>，在文章中将相应的显示数学公式。如：
　　　　　<m>a+b</m> ==> a+b
　　　　　<m>a-b</m> ==> a-b
　　　　　<m>a*b</m> ==> a*b
　　　　　<m>a/b</m> ==> a/b
　　　　　<m>a^b</m> ==> a^b
　　　　　<m>a_b</m> ==> a_b
　　　　　<m>a<>b</m> ==> a<>b
　　　　　<m>a>=b</m> ==> a>=b
　　　　　<m>sqrt{a}</m> ==> sqrt{a}
　　　　　<m>root{n}{a}</m> ==> root{n}{a}
　　　　　<m>lim{a}{x}</m> ==> lim{a}{x}
　　　　　<m>sum{a}{b}{x}</m> ==> sum{a}{b}{x}
　　这些只是最基本的几个例子，详细请参考我翻译的PhpMathPublisher中文帮助文档或PhpMathPublisher官方英文帮助文档，里面有基本的数学命令或数学符号对应的数学公式说明，既PhpMathPublisher自己定义的数学命令公式语法。利用这些基本的命令，可以组合出很复杂的数学公式，如：
　　<m>S(f)(t)=a_{0}+sum{n=1}{+infty}{a_{n} cos(n omega t)+b_{n} sin(n omega t)}</m> 　　
　==>
　　S(f)(t)=a_{0}+sum{n=1}{+infty}{a_{n} cos(n omega t)+b_{n} sin(n omega t)}
　　在PhpMathPublisher官方主页上有一个Online Demo,可以在线练习和测试各种数学公式表达式，用户可以方便的输入自己设计的数学命令，点击按钮“See”后可以看到生成的数学公式是否满足自己的要求，这样很容易修改自己的数学命令。

下载及安装说明
　　目前WpMathEditor的版本是0.1，在WordPress官网的正式地址在：
　　　http://wordpress.org/extend/plugins/wpmatheditor/
　　我在www.52nlp.com上为其写了英文说明，52nlp.com作为52nlp.cn的英文站存在，WpMathEditor的英文说明地址在：
　　　http://www.52nlp.com/wpmatheditor/
　　下载请在WordPress官网上下载。
　　安装说明：
　　1 将其上传到 wp-content/plugins 目录下并解压；
　　2 确保 wp-content/plugins/WpMathEditor/
phpmathpublisher/img 目录可写可读，最好将其设置为755权限；
　　3 在WordPress控制面板的插件里将其启用即可。
　　注：其中第2条非必要条件，如果安装时出现问题，就要考虑img目录的权限问题。

补充说明
　　目前WpMathEditor 0.1版已在”我爱自然语言处理“上测试了一段时间，比较稳定。如果您下载了这个WordPress中新的公式编辑器插件，在使用过程中发现任何bug，遇到任何问题和有什么好的建议，请在这里留言，我将及时给予解答。

注：原创文章，转载请注明出处“我爱自然语言处理”：www.52nlp.cn

本文链接地址：
http://www.52nlp.cn/my-first-wordpress-plugin-wpmatheditor/

相关文章:

1. WpMathEditor正式安家 (16.5)

2. PhpMathPublisher与wpmathpub修改 (11.6)

3. WordPress中的公式编辑器插件 (11.5)

4. 感谢ExWebs，回归Host2ez (2)

5. 共建词库等基础NLP资源的倡议 (2)