diff options
| author | IskandarMa <epiciskandar@gmail.com> | 2022-01-19 02:24:02 +0800 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-01-18 18:24:02 +0000 |
| commit | f6a7f4d4aca4a1808850e2dcd8cc223ae5202062 (patch) | |
| tree | fefc9beff20ea6438e9c1927d83319ed4c85a6b0 /docs/zh-cn/configurator_step_by_step.md | |
| parent | 8a3dfe2246c4a6182cf18349e9c4d0d28cae4ec5 (diff) | |
| download | qmk_firmware-f6a7f4d4aca4a1808850e2dcd8cc223ae5202062.tar.gz qmk_firmware-f6a7f4d4aca4a1808850e2dcd8cc223ae5202062.zip | |
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>
Diffstat (limited to 'docs/zh-cn/configurator_step_by_step.md')
| -rw-r--r-- | docs/zh-cn/configurator_step_by_step.md | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/docs/zh-cn/configurator_step_by_step.md b/docs/zh-cn/configurator_step_by_step.md new file mode 100644 index 000000000..bbfb71d5a --- /dev/null +++ b/docs/zh-cn/configurator_step_by_step.md | |||
| @@ -0,0 +1,63 @@ | |||
| 1 | # QMK 配置器: 入门 | ||
| 2 | |||
| 3 | <!--- | ||
| 4 | original document: 0.15.12:docs/configurator_step_by_step.md | ||
| 5 | git diff 0.15.12 HEAD -- docs/configurator_step_by_step.md | cat | ||
| 6 | --> | ||
| 7 | |||
| 8 | 本章节描述了如何使用QMK配置器构建出固件文件的过程。 | ||
| 9 | |||
| 10 | ## 第一步:选择键盘 | ||
| 11 | |||
| 12 | 从下拉列表中选择一款用于创建键映射的键盘。 | ||
| 13 | |||
| 14 | ?> 当键盘有多个版本可选择时,请确保选择正确。 | ||
| 15 | |||
| 16 | 因为很重要,这里我再次说一遍: | ||
| 17 | |||
| 18 | !> **请选择正确的版本!** | ||
| 19 | |||
| 20 | 如果你的键盘声称是基于QMK的但未在列表中,可能是开发者还未提交给我们,或者提交还未被合并进来。若在[Pull Request](https://github.com/qmk/qmk_firmware/pulls?q=is%3Aopen+is%3Apr+label%3Akeyboard)中没有找到请求支持该键盘的issue,请到[QMK固件](https://github.com/qmk/qmk_firmware/issues)提交一个issue。也有一些基于QMK的键盘是由制造商自己的GitHub账号在维护着,请也确认一下。 <!-- FIXME(skullydazed): This feels too wordy and I'm not sure we want to encourage these kinds of issues. Also, should we prompt them to bug the manufacutrer? --> | ||
| 21 | |||
| 22 | ## 第二部:选择键盘配列 | ||
| 23 | |||
| 24 | 选择最适合你要创建的键映射的配列,一些键盘的配列不完整或有问题,后续会逐渐支持。 | ||
| 25 | |||
| 26 | !> 有时会遇到没有特别适合的配列的情况,请选择 `LAYOUT_all`。 | ||
| 27 | |||
| 28 | ## 第三步:命名你的键映射 | ||
| 29 | |||
| 30 | 如何起名完全取决于你。 | ||
| 31 | |||
| 32 | ?> 如果编译时遇到了问题,可能是因为QMK固件代码库中已经有了同名项,可以尝试改一下名字。 | ||
| 33 | |||
| 34 | ## 第四步:设计你的键映射 | ||
| 35 | |||
| 36 | 以下三种方法可以添加键码: | ||
| 37 | |||
| 38 | 1. 拖拽 | ||
| 39 | 2. 点击布局上的空白项,再点击所需的键码 | ||
| 40 | 3. 点击布局上的空白项, 再点击你物理键盘上的按键 | ||
| 41 | |||
| 42 | ?> 鼠标在键上悬停时会有一个键码值的提示出现,详细描述信息请参见: | ||
| 43 | |||
| 44 | * [基础键码资料](zh-cn/keycodes_basic.md) | ||
| 45 | * [进阶键码资料](zh-cn/feature_advanced_keycodes.md) | ||
| 46 | |||
| 47 | !> 如果你选择的配列与物理实机有出入,请将不需要的按键留空。如果不清楚应该用哪个键,例如,你只需要一个退格键,但 `LAYOUT_all` 中有两个退格键,须将两个键都放上一样的键码。 | ||
| 48 | |||
| 49 | ## 第五步:保存键映射留待后续修订 | ||
| 50 | |||
| 51 | 当你调整完毕键映射方案,或打算以后继续编辑,点击 `导出Keymap JSON文件(Download this QMK Keymap JSON File)` 按钮,当前键映射方案将保存到你的计算机中,之后可以点击 `导入Keymap JSON文件(Upload a QMK Keymap JSON File)` 按钮导入后继续编辑。 | ||
| 52 | |||
| 53 | !> **注意:** 导出的.json文件与 kbfirmware.com 和其它工具软件生成的并不兼容,如果你将导出的数据放到那些工具中,或尝试导入那些工具生成的.json文件,是不可行的。 | ||
| 54 | |||
| 55 | ## 第六步:编译固件 | ||
| 56 | |||
| 57 | 点击绿色的 `编译(Compile)` 按钮。 | ||
| 58 | |||
| 59 | 编译完成后,可以点击绿色的 `固件(Download Firmware)` 下载固件文件。 | ||
| 60 | |||
| 61 | ## 下一步:刷写到键盘中 | ||
| 62 | |||
| 63 | 参见[刷写固件](zh-cn/newbs_flashing.md). | ||
