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>
This commit is contained in:
parent
8a3dfe2246
commit
f6a7f4d4ac
51 changed files with 3973 additions and 1389 deletions
|
@ -1,19 +1,58 @@
|
|||
# 常见问题
|
||||
# 常见问题(FAQ)
|
||||
|
||||
## QMK是什么?
|
||||
<!---
|
||||
original document: 0.15.12:docs/faq_general.md
|
||||
git diff 0.15.12 HEAD -- docs/faq_general.md | cat
|
||||
-->
|
||||
|
||||
[QMK](https://github.com/qmk), 是量子机械键盘(Quantum Mechanical Keyboard)的缩写,是一群开源爱好者为定制键盘开发的工具。我们从[QMK固件](https://github.com/qmk/qmk_firmware)开始,这是[TMK](https://github.com/tmk/tmk_keyboard)的魔改分叉。
|
||||
## QMK是什么?
|
||||
|
||||
### 为什么叫量子(Quantum)?
|
||||
[QMK](https://github.com/qmk), 是量子机械键盘(Quantum Mechanical Keyboard)的缩写, 是制作自定义键盘工具的人组成的组织。 一切始于[QMK固件](https://github.com/qmk/qmk_firmware)项目, 可以认为是[TMK](https://github.com/tmk/tmk_keyboard)的改进版本.
|
||||
|
||||
<!-- 待修复 译者吐槽:文档作者竟然也不知道为啥。。。 -->
|
||||
## 不知道从哪开始搞!
|
||||
|
||||
## QMK和TMK有什么区别?
|
||||
这样的话建议从[新手指引](zh-cn/newbs.md)开始。那里有你需要的高质量的入门信息。
|
||||
|
||||
TMK最初由[Jun Wako](https://github.com/tmk)设计和执行。QMK始于[Jack Humbert](https://github.com/jackhumbert)为Planck键盘创建的TMK分叉。一段时间后,Jack的分叉就和TMK相去甚远了,于是在2015年,Jack决定改名QMK。
|
||||
如果还是搞不懂的话,直接跳到[QMK配置器](https://config.qmk.fm)吧,你核心需要的东西都在那里。
|
||||
|
||||
从技术观点来讲,QMK是TMK添加一些新功能而成的。尤其是QMK扩展了可用的键码,使高级功能进一步丰富比如 `S()`, `LCTL()`, 和 `MO()`。全部键码见[键码](keycodes.md).
|
||||
## 我的固件如何刷写到硬件上?
|
||||
|
||||
从工程的社区管理来讲TMK自己维护了所有官方支持的键盘,只有很小一部分社区支持。独立社区维护已存在分叉或为其他键盘创建的分叉。默认支持很少的键码,所以用户通常不会与他人分享布局。QMK鼓励通过集中管理仓库分享布局和键盘,我们会采纳所有符合质量标准的PR。这就极大的保证了社区维护,同时QMK小组也会在必要时给予帮助。
|
||||
先参考[编译/刷写固件FAQ](zh-cn/faq_build.md),里面有充足的资料,常见的问题也给出了足够多的解决办法。
|
||||
|
||||
这两种方法都有其优点和缺点,并且代码在有意义时在TMK和QMK之间自由流动。
|
||||
## 我的问题这里找不到相关信息怎么办?
|
||||
|
||||
没有关系,请到[GitHub上发issue](https://github.com/qmk/qmk_firmware/issues)看看是否有人遇到了相同的问题(留意一定是相同的问题,而不是相似的)。
|
||||
|
||||
如果还是找不到解决办法,请[新建issue](https://github.com/qmk/qmk_firmware/issues/new)!
|
||||
|
||||
## 我好像找到了bug?
|
||||
|
||||
那么新建一个[issue](https://github.com/qmk/qmk_firmware/issues/new)吧,如果你还知道怎么修,带着修复方案发个Pull Request吧。
|
||||
|
||||
## 但是 `git` 和 `GitHub` 我实在是玩不转!
|
||||
|
||||
别担心,这里有很好的[入门指引](zh-cn/newbs_git_best_practices.md)可以教你怎么轻松快乐地使用 `git` 和GitHub进行开发。
|
||||
|
||||
更多的 `git` 和GitHub知识,参考[这里](zh-cn/newbs_learn_more_resources.md)。
|
||||
|
||||
## 我可以添加一个支持的键盘
|
||||
|
||||
太棒啦!请发Pull Request吧,在代码审阅后,我们会合并进去!
|
||||
|
||||
### 我可以打上 `QMK` 的标吗?
|
||||
|
||||
很好啊!我们甚至乐意帮你这么做!
|
||||
|
||||
我们有[一整页](https://qmk.fm/powered/)的资料旨在帮你在页面和键盘上打上QMK的标,里面有QMK官方提供的所有支援(信息及图片)。
|
||||
|
||||
如果你有任何疑问,可以发issue或通过[Discord](https://discord.gg/Uq7gcHh)联系我们。
|
||||
|
||||
## QMK和TMK区别是什么?
|
||||
|
||||
TMK原先是由[Jun Wako](https://github.com/tmk)设计实现的,QMK来源于[Jack Humbert](https://github.com/jackhumbert)的Planck的TMK fork。一段时间后,Jack的这个fork与TMK渐行渐远,到2015年时,Jack决定将这份fork重命名为QMK。
|
||||
|
||||
技术上讲QMK等同于基于TMK增加了一些新功能,最显著的是在扩充了可用键码后,实现了很多诸如 `S()`, `LCTL()` 及 `MO()` 这样的高级功能,所有这些键码可以参见[键码](zh-cn/keycodes.md)页。
|
||||
|
||||
从工程项目及社区维护角度来看,TMK维护了一份官方支持的键盘及很少量的社区贡献,社区中各自维护着各自的fork,且因为默认键映射很少,TMK的使用者基本不会共享键映射。QMK通过统一的集约式仓库(repo)管理来鼓励分享键盘及键映射,任何符合质量基线的pull request都会被采纳,因此绝大部分贡献都来源于社区,QMK小组会在必要时提供支援。
|
||||
|
||||
两种模式各有利弊,并且TMK和QMK之间也会有合乎理法的代码交流。
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue