MathJax用于易学领域

关于利用 MathJax 和 Katex 数学公式解释器，实现易学上排六爻盘和八字盘个功能。今天实现了易学上的核心功能。有望将来能添加更多的函数，以便利各位同门以及广大易友。

效果与演示

无法观看油管的朋友请移步B站：[使用MathJax渲染六爻和八字盘](https://www.bilibili.com/video/av66317810/)

安装和使用

首先，你需要一个支持 Markdown (简称MD) 语言格式的文本编辑器。如果不知道什么是MD的话，请参阅以下介绍：

Markdown 语言简约而优美，可以自由转换成pdf、word、Html 等等各种其它格式的文本。可以推送到博客、微信公众号等等。虽然算卦是一个传统的行业，我们仍然不宜固步自封。MD语言支持MathJax和Katex书写Latex数学公式，可以写出非常漂亮的数学、物理、化学方面的公式。正式的科技刊物都要求用Latex格式。

这个易学解决方案是对 MathJax 进行扩展，加入指定的易学公式，让 MathJax 解释器去完成公式渲染。它并不是一个独立的程序。需要构建在已有的MD文本编辑器之上。我使用一个文件夹存放所有的关于易学方面的MD文件，并将这个文件夹同步到坚果云，这样就可以实现多台电脑和移动端之间的同步，而不太需要一个独立的易学软件。甚至可以将MD文件导出为HTML文件，放到我的HEXO博客上(您正在阅读的这篇博文即是例子)。

理论上所有支持Markdown语言和MathJax的文本编辑器，都可以改装。改装过程需要两段代码和一个库文件。

文本编辑器

Typora

Typora 是我个人最钟爱的MD编辑器，因此这里着重介绍。如果你喜欢用别的MD编辑器，比如iAWrte等，理论上可以用同样的方式改装。(无法百分百保证) 有需要的朋友可以私下联系我。

最新的安装教程请参考华鹤易学平台文档

VSCode

同样请移步华鹤易学平台文档。那里有详细描述。

Hexo博客

🔔 注意：首先要检查自己的 Hexo 博客使用的渲染器是否默认开启了Katex或者MathJax数学插件。如果有的话需要卸载或者禁用数学插件，如果不能禁用，就必须更换Markdown渲染器。

因为系统使用的数学插件会在网页生成之前就改动数学表达，这样无法使用我提供给的函数库。我提供给博客的方案是在浏览网页的时候，即时渲染易学公式。

比如我之前用了 “hexo-renderer-markdown-it-plus” 渲染器就是强制使用 Katex 数学渲染的。

1 2	npm un hexo-renderer-markdown-it-plus --save // 卸载 npm i hexo-renderer-markdown-it --save // 更换

然后将下列代码添加到文件模版就可以了。使用 swig 模版的是在 <your thems>/layout/_custom/header.swig 或者 <your thems>/layout/index.swig 。而使用 ejs 模版的是文件 <your thems>/layout/layout.ejs

<!--前三行最好添加到 <header></header> 头区块中-->

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.11.0/dist/katex.min.css" >
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.11.0/dist/katex.min.js" ></script>
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.11.0/dist/contrib/auto-render.min.js"></script>


<script src="https://raw.githack.com/maiernte/img/master/libs/katexYixue.js"></script>
<script src="https://raw.githack.com/maiernte/img/master/libs/bundle.js"></script>

注意搜索 _config.yml 文件，“math”, “katex”, “mathjax” 等字样，发现有的话把他们禁用。

Gitbook

最新的安装教程请参考华鹤易学平台文档

API 参数

使用易学函数库非常简单，在经过改装的Markdown编辑器中，输入易学公式，并用两个 $ 符号将公式前后围起来即可。MD语言一般默认两个 $ 符号之间的文本是数学公式，它会调用MathJax对公式进行渲染。否则，它会认为这是普通文本，而不会做任何动作。

易学通用

命令：纳音 \nayin{干支名称}

【干支名称】：就是甲子、己卯等六十甲子。

例子1：\nayin{戊午} --> $\nayin{戊午}$

命令：干支日历 \timegz{时间参数}{年月日}

【时间参数】：例如 2020-02-21。

【年月日】：省略时默认为111，即显示年月日。0表示不显示，1表示显示。

例子1：\timegz{2020-02-21} --> $\timegz{2020-02-21}$

例子2：\timegz{2020-02-21}{011} --> $\timegz{2020-02-21}{011}$

六爻

命令：爻符 \yao{爻名}

【爻名】：laoyin， laoyang，shaoyin，shaoyang， x， o， =， -，交，重，阴，阳，0，1，2，3

例子2：\yao{x} --> $\yao{x}$

例子3：\yao{shaoyin} --> $\yao{shaoyin}$

例子4：\yao{重} --> $\yao{重}$

命令：六爻排盘 \paigua{时令}{卦辞}{标识}

其中【时令】、【卦辞】这两个参数是必须的，**【标识】**参数可以省略。

【时令】允许的格式为：“1980-1-3 08:15”、“2019年3月4日”、“申月戊寅日”

【卦辞】允许的格式为：“解之师”、“离为火”、“–==x-”、“0121100”、“阴阳阴交阴阳”

【标识】由三部分组成：ID号、简排、字符大小。格式为：guadi/s/5

「ID号」：随便一串字符，空白则默认为“gua1”。:x:不允许只有数字，因为会与参数「字符大小」混淆。如果一个文本出现多个六爻卦，则每个卦都需要指定一个ID号。否则下面的命令卦爻细节不知道具体指向哪一个卦本。
「简排」：只允许s 和 l两个英文字符的其中一个。s 表示只显示短名，如“妻财”显示为“财”，“青龙”显示为“龙”。l 则显示完整名称。留白则按照用户全局设定来显示。（参阅用户设定）
「字符大小」：允许 0 - 9 档。数字越大文字越大。默认大小为5或者用户的全局设定。

例子5： $\paigua{1978年7月1日}{101201}{gua1}$ 效果
$$\paigua{1978年7月1日}{101201}{gua1}$$

:pencil2: 如果文章很长，需要在指定位置重新显示一遍卦本，则可以使用重排命令。即让【时令】和【卦辞】两个参数留白，只给出【ID号】。如 \paigua{}{}{gua1} 。留白的参数，仍然需要用大括号括起来，否则解释器会出错。

命令：卦爻细节 \guayao{标识}{位置}

使用前提：当前文本中已经排出至少一支六爻卦。

【标识】：与排盘命令的「标识」参数等同。由ID号、简排、字符大小三个部分组成。其中「ID号」标识已经存在的六爻盘。

【位置】：格式为 “ben1”、“fu3”、“bian5” 等，分别表示「本卦初爻」、「伏卦3爻」、「变卦5爻」

例子6：\guayao{gua1}{ben4} --> $\guayao{gua1}{ben4}$

例子6 中给出的「ID号」为例子5中指定的ID号 “gua1”，并要求显示本卦4爻的具体信息。

八字

命令：八字排盘 \paibazi{时间}{性别}{标识}[细节]

【时间】和【性别】参数必填，【标识】和【细节】参数可选。(如果要第二次显示已有的八字盘，则【时间】和【性别】参数可留白，只给定【标识】参数中的「ID号」)

【时间】：允许格式 “1980-1-3 08:15”、“2019年3月4日 6时3分”

【性别】：允许格式 “m”、“f”、“男”、“女”、“乾”、“坤”、

【标识】：与排盘命令的「标识」参数等同。由ID号、简排、字符大小三个部分组成。

【细节】：允许“藏干”、“长生”、“纳音”这三个中的一个或者多个，也可以留白。格式为 藏干/纳音/长生

例子7：\paibazi{1990年5月1日 6:45}{男}{小明/s/5}

$\paibazi{1990年5月1日 6:45}{男}{小明/5}$

例子8：重排例子7的八字盘 \paibazi{}{}{小明/s/5}[纳音/藏干/长生] ，并要求显示藏干和纳音等信息。

$\paibazi{}{}{小明/s/5}[纳音/藏干/长生]$

命令：八字细节 \bazi{标识}{类别}[细节]

使用前提：当前文本中已经排出至少一个八字盘。

【标识】：与排盘命令的「标识」参数等同。由ID号、简排、字符大小三个部分组成。其中「ID号」标识已经存在的八字命盘。

【类别】：支持 “神煞”、“大运”、“流年”、“小运” 四个选项。

【细节】：具体含义视【类别】而定。

类别为「神煞」时：「细节」为 1～ 9 的数字，表示每行列数。
类别为「大运」时： 1-9 纳音/藏干/长生/神煞 前面的数字表示第几步大运，限定 1 到 10
类别为「流年」和「小运」时： 2015 - 2019 纳音/藏干/长生/神煞 前面的数字表示年份，注意不要超过命盘的生命周期，否则会出错。「纳音/藏干/长生/神煞」可以留白，也可只显示一两项。

例子9: \bazi{小明}{神煞}[6] 显示小明命盘的神煞，每行6列。

$\bazi{小明}{神煞}[6]$

例子10: \bazi{小明}{大运}[2-3 ] 显示小明的第二到第三步大运

$\bazi{小明}{大运}[2-3]$

例子11: \bazi{小明}{流年}[2017-2019 纳音/藏干/长生/神煞] 显示小明的2017到2019年的流年信息。

$\bazi{小明}{流年}[2017-2019 纳音/藏干/长生/神煞]$