API 参数
使用易学函数库非常简单,在经过改装的Markdown编辑器中,输入易学公式,并用两个 {% math %} 符号将公式前后围起来即可。MD语言一般默认两个 {% endmath %} 符号之间的文本是数学公式,它会调用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”。❌不允许只有数字,因为会与参数「字符大小」混淆。如果一个文本出现多个六爻卦,则每个卦都需要指定一个ID号。否则下面的命令卦爻细节不知道具体指向哪一个卦本。
- 「简排」:只允许
s和l两个英文字符的其中一个。s表示只显示短名,如“妻财”显示为“财”,“青龙”显示为“龙”。l则显示完整名称。留白则按照用户全局设定来显示。(参阅用户设定) - 「字符大小」:允许 0 - 9 档。数字越大文字越大。默认大小为
5或者用户的全局设定。
例子5: {% math %}\paigua{1978年7月1日}{101201}{gua1}{% endmath %} 效果
$\paigua{1978年7月1日}{101201}{gua1}$
✏️ 如果文章很长,需要在指定位置重新显示一遍卦本,则可以使用重排命令。即让【时令】和【卦辞】两个参数留白,只给出【ID号】。如 \\paigua{}{}{gua1} 。留白的参数,仍然需要用大括号括起来,否则解释器会出错。
命令:六十四卦
\gua64{卦名}{标识}
其中【卦名】这两个参数是必须的,【标识】参数可以省略。
【卦辞】允许的格式为:“解之师”、“离为火”、“--==x-”、“0121100”、“阴阳阴交阴阳”
【标识】由两部分组成:简排、字符大小。格式为:s/5
- 「简排」:只允许
s和l两个英文字符的其中一个。s表示只显示短名,如“妻财”显示为“财”,“青龙”显示为“龙”。l则显示完整名称。留白则按照用户全局设定来显示。(参阅 [用户设定]) - 「字符大小」:允许 0 - 9 档。数字越大文字越大。默认大小为
5或者用户的 [全局设定]。
例子5a: \gua64{山火贲}效果
$\gua64{山火贲}$
命令:卦爻细节
\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 纳音/藏干/长生/神煞]$
中文关键字的支持
为了更好的使用体验,新增加了对中文关键字的支持。其对应关系如下:
纳音:对应\nayin卦爻:对应\guayao爻:对应\yao64卦:对应\gua64卦:对应\paigua命:对应\paibazi时令:对应\timegz
其中冒号是全角符号,
支持的分隔符(同样是全角符号): 【】、《》 、 「」 ,以下三个例子是完全等同的
例1 \paigua{1978年7月1日}{101201}{gua1}
例2 排卦:【1978年7月1日】【101201】【gua1】
例3 排卦:《1978年7月1日》《101201》《gua1》
例4 排卦:「1978年7月1日」「101201」「gua1」
未来与展望
我知道这篇文章介绍的工具,并非所有人都能使用。所以在不久的将来,还是要制作一个独立易学软件,以便易友在PC端和移动端都能按照传统的方式使用。但由于时间和精力原因,我无法保证完成时间。
不断完善易学函数,提供更丰富的应用细节。在用户更为广泛的MD编辑器中实现此方式。比如有道云笔记、为知笔记、印象笔记等。并争取介绍移动端(Android & iOS)实现此方式。
希望能将师父的六爻和八字讲义,『增删卜易』等著作制作成Gitbook,将精彩的卦例和名人八字建成易学数据库。这样就可以通过我的易学函数直接获取, 比如 \paibazi{蒋介石}。