Kanata配置指南

本文档介绍如何创建 kanata 配置文件。 kanata 配置文件将确定运行 kanata 时的键盘行为。

如何阅读指南

请参阅右上角的三重项目符号线来打开或关闭目录侧边栏。

您可能想要查看呈现为 HTML 的指南。链接到指南

参考部分较短，旨在检查配置不同部分的精确程度。描述部分更长，包含更多细节，例如建议、动机和示例。

您正在阅读的配置指南可能包含不适用于您所使用的版本的内容。请参阅下面的特定指南版本的链接。

• v1.7.0
• v1.6.1
• v1.6.0

前言

配置文件使用 Lisps 中的 S 表达式语法。如果您不熟悉任何类似 Lisp 的编程语言，也不必太担心。希望本文档能够成为一个足够的指南，帮助您根据自己的喜好自定义键盘行为。

早期学习的有用术语：

细绳	字符序列。可以选择用引号引起来。示例：退格键、“带有空格和 1 个数字的字符串”。
列表	圆括号内的字符串序列或嵌套列表。列表项由任意数量的空白字符或圆括号分隔。示例：(lrld-num 1)、(踢踏舞 200 (f1(unicode 😀)f2(unicode 🙂)))。

如果您有任何问题、困惑、建议等，请随时开始讨论或提出问题。如果您对如何改进本文档或项目的任何其他部分有任何想法，欢迎提出拉取请求或提出问题。

强制退出kanata

虽然这与配置无关，但您可能需要知道同时按住以下所有三个键将导致 kanata 退出：

• 左Ctrl
• Space
• Esc

该机制在 kanata 进行任何重新映射之前对按键输入起作用。