# 写在前面：为什么要做中文手册？

我最早了解到 `Keyboard Maestro` 是在王树义老师的节目中，我还记得当时老师给的示例是「如何将复制的文本，格式化为自己想要的样式」。那时尝试了一下，觉得功能很强大！

在此之前，我用过 `Alfred` 、 `atext` 、Mac自带的 `Automator` 。Keyboard Maestro的功能，上述App也都能实现，但一方面是功能比较分散，另一方面是 Keyboard Maestro 可以通过拖拽的方式来添加动作，这一点对新手更加友好，虽然`Automator`也可以通过拖拽的方式进行操作的添加，可能是我学的不深入，经常弄不明白其控制逻辑，用着不顺手。相比来说，`Keyboard Maestro` 的操作逻辑更为简单，对于新手更加友好。

### 至今没有中文手册可用

由于 `Keyboard Maestro` 的中文社区并没有发展起来，至今都没有中文手册。 有的人可能会说，官网有英文手册和英文Wiki，但是毕竟对于广大用户而言，阅读英文手册还是比较困难。

### 英文手册不完善

#### 英文手册内容不充实

英文手册内容不充实，查找资料需要反复跳转。 官方的英文手册简单介绍了各个功能模块，并给出了一些注意事项，对各功能模块没有进行深入地解释。例如，手册并没有对触发器和动作的具体条目进行讲解，要了解这部分的用法需要到官网Wiki中进行查找。

#### 英文手册的示例太简要，解释不够

英文手册也会给出一些示例，但示例很简要，没有详细的解释。

#### 官网 Wiki 撰写拗口

官网Wiki中有关各条目的介绍也很简略，文字表述很拗口，官方也没有给出更多的解释，有的句子即便是结合其给出的示例，也很难理解其要表达的真实含义。 例如在[输入字符串触发器](https://wiki.keyboardmaestro.com/trigger/Typed_String)条目有一段介绍：

> You can limit the typed string trigger to only work after a word break (which means any non-alphanumeric character, or any case that cancels the sequence as described above). Note that this means the match will happen only after you type a word break and then the Typed String - Keyboard Maestro does not know what you will type in the future so it cannot restrict matches to only happen if you plan to type a word break next. 

翻译过来：

> 您可以将键入的字符串触发器限制为仅在断字后起作用（这意味着任何非字母数字字符，或取消上述序列的任何情况）。请注意，这意味着仅在您键入分词符、然后键入字符串后才会发生匹配， - Keyboard Maestro 无法预知你未来会键入什么，所以它不能仅在你计划接下来键入一个词边界时才匹配字符串。这意味着，触发条件的检测只能在你实际完成键入动作之后进行，而不是基于你未来的键入计划。 

看完之后，我们会发现，即使翻译成中文，上述内容也很难理解，具体解释请参见本手册 [#id-3.-hou-xu-jie-de-nei-rong-zhong-lei](https://km.qxpai.cn/chu-fa-qi-trigger/shu-ru-zi-fu-chuan-chu-fa-qi#id-3.-hou-xu-jie-de-nei-rong-zhong-lei "mention")。

所以，我想做这个中文手册，目的是方便大家更好地查询资料、更好地理解每一项操作的含义，对难理解的操作进行解释，并通过示例直观地展示，方便大家更好地理解、更好地使用这款软件。

### 市面上的教程不能能满足需求

市面上存在的一些教程也好，使用心得也好，更多的聚焦于具体场景下的设置，但是据对于具体设置的含义，并没有进行清楚地解释，也没有对各触发器和动作中需要注意的事项进行明确地说明和解释，每个接触Keyboard Maestro的用户都需要重新摸索，提高了使用门槛。

### 这本手册有什么特点？

* 方便查找：将英文手册与官网Wiki相结合，只需要在这一处就可以解决您的大部分疑问。
* 对条目进行充分释义，帮助大家更好地理解每一项的真实含义。
* 配合更多的示例，用图片和`Gif`的形式，更直观地展示具体用法及不同条目之间的区别。
* 配套有详细视频教程，目前视频教程正在开发中，敬请期待！