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号。否则下面的命令卦爻细节不知道具体指向哪一个卦本。
  • 「简排」:只允许sl两个英文字符的其中一个。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

  • 「简排」:只允许sl两个英文字符的其中一个。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
  • 爻: 对应 \yao
  • 64卦: 对应 \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{蒋介石}

results matching ""

    No results matching ""