qmk_firmware/docs/zh-cn/feature_space_cadet.md
IskandarMa f6a7f4d4ac
update the Chinese translation based on the latest English version (#14924)
Co-authored-by: peepeetee <43021794+peepeetee@users.noreply.github.com>
Co-authored-by: Joy Lee <chang.li@westberrytech.com>
Co-authored-by: LitoMore <LitoMore@users.noreply.github.com>
Co-authored-by: Dasky <32983009+daskygit@users.noreply.github.com>
2022-01-18 18:24:02 +00:00

71 lines
5.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Space Cadet: The Future, Built In
<!-- Deliberately not translated, leave it to a suitable translation -->
<!---
original document: 0.15.12:docs/feature_space_cadet.md
git diff 0.15.12 HEAD -- docs/feature_space_cadet.md | cat
-->
*译注Space Cadet来源于(在西方早期程序员中)著名的键盘Space Cadet Keyboard具体信息参见下面的链接或[维基百科](https://en.wikipedia.org/wiki/Space-cadet_keyboard)*
Steve Losh 在 [Space Cadet Shift](https://stevelosh.com/blog/2012/10/a-modern-space-cadet/) 详细地描述了该功能. 简而言之点击左Shift时会输出左括号点击右Shift时会输出右括号。如果按住Shift键常规的Shift将正常工作。这功能实际上和听起来的一样爽更爽的是现在连Control和Alt也支持
## 使用指南
首先,在你的配列中完成以下任一项:
- 替换左Shift为 `KC_LSPO`左Shift左括号替换右Shift为 `KC_RSPC`右Shift右括号
- 替换左Control为 `KC_LCPO`左Control左括号替换右Control为 `KC_RCPC`右Control右括号
- 替换左Alt为 `KC_LAPO`左Alt左括号替换右Alt为 `KC_RAPC`右Alt右括号
- 替换任意一个Shift为 `KC_SFTENT`右Shift回车
## 键码
|键码 |描述 |
|-----------|-----------------------------|
|`KC_LSPO` |按住时左Shift点击时 `(` |
|`KC_RSPC` |按住时右Shift点击时 `)` |
|`KC_LCPO` |按住时左Control点击时 `(` |
|`KC_RCPC` |按住时右Control点击时 `)` |
|`KC_LAPO` |按住时左Alt点击时 `(` |
|`KC_RAPC` |按住时右Alt点击时 `)` |
|`KC_SFTENT`|按住时右Shift点击时回车 |
## 须留意
同时按下两边的Shift键时会与Space Cadet功能冲突。请参见[指令功能](zh-cn/feature_command.md)以了解如何解决,也可以在 `rules.mk` 中禁用指令:
```make
COMMAND_ENABLE = no
```
## 配置
默认情况下Space Cadet假设键盘布局为US ANSI如果你的布局使用不同的括号符可以在 `config.h` 中重定义。可以修改修饰键点击时发送的字符,亦或阻止修饰键工作。这个新的配置项依次绑定了三个键码:按住或组合其它键使用时的修饰键;点击时发送的修饰键点击(`Tap Modifier`)(在 `KC_TRNS` 中没有修饰键时);最后是点击时发送的键码。请记住,例如'KC_RSFT'按住时点击 `KC_KSPO``KC_TRNS` 时,修饰键依旧会对键码生效,即属于修饰键点击。
|定义 |默认值 |描述 |
|----------------|-------------------------------|----------------------------------------------------------------|
|`LSPO_KEYS` |`KC_LSFT, LSPO_MOD, LSPO_KEY` |按住时发送`KC_LSFT`,点击时发送 `LSPO_MOD``LSPO_KEY` 定义的键码. |
|`RSPC_KEYS` |`KC_RSFT, RSPC_MOD, RSPC_KEY` |按住时发送`KC_RSFT`,点击时发送 `RSPC_MOD``RSPC_KEY` 定义的键码. |
|`LCPO_KEYS` |`KC_LCTL, KC_LSFT, KC_9` |按住时发送`KC_LCTL`,点击时发送 `KC_LSFT``KC_9`. |
|`RCPC_KEYS` |`KC_RCTL, KC_RSFT, KC_0` |按住时发送`KC_RCTL`,点击时发送 `KC_RSFT``KC_0`. |
|`LAPO_KEYS` |`KC_LALT, KC_LSFT, KC_9` |按住时发送`KC_LALT`,点击时发送 `KC_LSFT``KC_9`. |
|`RAPC_KEYS` |`KC_RALT, KC_RSFT, KC_0` |按住时发送`KC_RALT`,点击时发送 `KC_RSFT``KC_0`. |
|`SFTENT_KEYS` |`KC_RSFT, KC_TRNS, SFTENT_KEY` |按住时发送`KC_RSFT`,点击时发送 `SFTENT_KEY`. |
|`SPACE_CADET_MODIFIER_CARRYOVER` |*未定义* |在尝试触发其它修饰键的修饰键点击前暂存目前的修饰键。这在尝试触发Space Cadet前频繁发生修饰键提前松开时会有用。(译注[^1]) |
## 过时的配置项
以下是一些内部用于向后兼容的定义,目前仍可以使用,但上面的定义适用性要强得多。例如,若你点击 `KC_LSPO` 时不想按住修饰键,在旧定义中只有一个办法,使用 `DISABLE_SPACE_CADET_MODIFIER`。但现在可以定义为:`#define LSPO_KEYS KC_LSFT, KC_TRNS, KC_9`效果是在按住按键时触发左Shift点击则发送 `KC_9`
|定义 |默认值 |描述 |
|------------------------------|-------------|-------------------------------------|
|`LSPO_KEY` |`KC_9` |点击左Shift时发送的键码 |
|`RSPC_KEY` |`KC_0` |点击右Shift时发送的键码 |
|`LSPO_MOD` |`KC_LSFT` |应用在 `LSPO_KEY` 上的修饰键 |
|`RSPC_MOD` |`KC_RSFT` |应用在 `RSPC_KEY` 上的修饰键 |
|`SFTENT_KEY` |`KC_ENT` |点击Shift时发送的键码 |
|`DISABLE_SPACE_CADET_MODIFIER`|*未定义* |定义时将阻止修饰键应用在Space Cadet上 |
[^1]这句实在是绕,不能确保翻译到位,请参考英文文档