Liii STEM 的宏命令创建

Liii STEM 支持自定义宏，以及从 $\LaTeX$ 中直接导入宏。以下指南将带您了解宏并掌握使用宏的方法。

1 什么是宏？

在 数学公式编辑 中，我们已经掌握了如何标注公式等。为什么要在已有的公式上再加一层标注呢？其中一个的原因是我们希望 引入缩写来简化冗长的名称或复杂的符号 ，从而节省输入的时间。通过定义宏，我们也可以实现这一点。

• 宏（Macro）是一段我们根据自己的需求，预先录制的命令或代码片段，用来自动执行重复性任务。

再举个简单的例子。假设您在文章中需要多次提到 Southern University of Science and Technology ，那么您可以在 Liii STEM 中引入一个新的宏 sustech 作为以上五个单词的缩写，定义完成的宏可以重复使用，这大大减轻了您输入的压力。

2 宏使用的基本方法

2.1 创建一个宏

• 在菜单栏，依次点击 工具 -> 宏命令 -> 新建宏 。

• 点击 enter-name ，输入您想定义的宏的 名称 。
• 在 enter-body 部分，输入宏的 内容 。
• 最后点击 使用 -> 确认。

• 按 \ 进入命令模式，输入您定义的宏名称，敲击 回车 ，完成宏的创建与使用。

2.2 添加参数

按照章节2.1的步骤，将 Macro editor 面板左下角调至 数学 ，您可以定义数学类型的宏。

您还可以添加额外的宏参数，从而在每次使用宏时，在参数位置能够输入不同的内容。例如，每次都可以更改上述图片中矩阵的符号 x 和 n 。具体方法如下。

• 输入宏名称后，点击 Alt + → 添加宏参数。
• 在宏内容中参数对应的位置，点击 \ ，输入参数名称，敲击 回车。

2.3 定义现有的宏

Liii STEM 中有许多已定义的宏，您可以通过点击菜单栏上的 工具 -> 宏命令 -> 编辑宏 打开 宏编辑器 ，进行个性化的定义。

如果您操作熟练或是需要编辑较为复杂的宏，推荐您使用以下两种方法。

• 将 Macro editor 面板左下角调至 源码 来编辑宏。
• 在菜单栏上点击 文档 -> 部分 -> 显示序言 ，在 导言区 内编辑宏。

3 在导言区编辑宏

3.1 进入导言区

• 菜单栏点击 文档 -> 部分 -> 显示序言 。
• 或在 MacBook 中使用快捷键 Alt + Cmd + P，在 Windows 系统中可使用快捷键 Alt + Windows + P。

3.2 在导言区编辑宏

进入导言区后，您可以看到您此前创建的宏。
此时，您可以直接在导言区对其进行修改参数、名称以及内容等编辑操作。

3.3 在导言区创建宏

您在导言区也可以直接创建宏。

• 进入导言区后，输入 \ 进入命令模式，再输入 assign ，敲击 回车 。
• 或通过 Ctrl + Alt + = 快捷键快速开始创建。
• 此时会出现 <assign||> 字样，在第一个 | 后输入宏的名称，在第二个 | 后添加宏的内容。

一些 tips

1. 定义参数时需要使用 macro 命令（即输入 \+macro）将宏内容套起来；之后您可以使用 Alt + → 添加宏参数。
2. 宏中间可以嵌套已经定义好的宏。对于一些复杂的宏，如矩阵，您可以在输入 \+matrix 后点击命令栏中的 激活，此时可以展开宏等结构方便您快速编辑。

3. 通过 math 命令（\ + math）可以进入数学模式编辑，进入数学模式后您可以调用一些在数学模式下可调用的宏。
4. 通过导言区您可以使用 if 等条件判断指令。

一个示例

如下是一个通过导言区创建宏的示例，该宏实现了判断两个参数是否相等的功能。

<assign|test-equal|<macro|arg1|arg2|msg|<if|<equal|arg1|arg2>|Same quantity:arg1|Not equal:msg>>>

4 从 LaTeX 导入宏

我们支持从 $\LaTeX$ 直接导入宏，具体方法如下。

• 复制 $\LaTeX$ 的宏命令。
• 点击 文档 -> 部分 -> 显示序言 ；或使用快捷键 Alt + Cmd + P，进入导言区。
• 点击 右键 -> 粘贴自 -> LaTex ，即完成宏的导入。