docs/zh-cn/getting_started_github.md

   1 # 如何在QMK中使用Github
   2
   3 Github can be a little tricky to those that aren't familiar with it - this guide will walk through each step of forking, cloning, and submitting a pull request with QMK.
   4
   5 ?> 本教程假设您已安装GitHub，并且您喜欢使用命令行工作。
   6
   7 首先 [Github上的QMK页面](https://github.com/qmk/qmk_firmware), 您能看到右上方有个按钮写着"Fork":
   8
   9 ![从Github上分叉](http://i.imgur.com/8Toomz4.jpg)
  10
  11 如果你是某组织成员，你将需要选择分叉到哪个账户。一般情况下, 你是想要分叉到你的私人账户下。当你完成分叉 (有时需要等一会), 点击"Clone or Download" 按钮:
  12
  13 !从Github下载](http://i.imgur.com/N1NYcSz.jpg)
  14
  15 你要选择 "HTTPS", 然后选择链接复制:
  16
  17 ![HTTPS链接](http://i.imgur.com/eGO0ohO.jpg)
  18
  19 然后，在命令行输入`git clone `，然后粘贴你的链接:
  20
  21 ```
  22 user@computer:~$ git clone https://github.com/whoeveryouare/qmk_firmware.git
  23 Cloning into 'qmk_firmware'...
  24 remote: Counting objects: 46625, done.
  25 remote: Compressing objects: 100% (2/2), done.
  26 remote: Total 46625 (delta 0), reused 0 (delta 0), pack-reused 46623
  27 Receiving objects: 100% (46625/46625), 84.47 MiB | 3.14 MiB/s, done.
  28 Resolving deltas: 100% (29362/29362), done.
  29 Checking out files: 100% (2799/2799), done.
  30 ```
  31
  32 现在你本地计算机有QMK的分叉了,你可以添加你的布局了, 为你的键盘编译并刷新固件吧。如果你觉得你的修改很不错, 你可以添加,提交,然后想你的分叉推出（pull）你的改变，像这样:
  33
  34 ```
  35 user@computer:~$ git add .
  36 user@computer:~$ git commit -m "adding my keymap"
  37 [master cccb1608] adding my keymap
  38  1 file changed, 1 insertion(+)
  39  create mode 100644 keyboards/planck/keymaps/mine/keymap.c
  40 user@computer:~$ git push
  41 Counting objects: 1, done.
  42 Delta compression using up to 4 threads.
  43 Compressing objects: 100% (1/1), done.
  44 Writing objects: 100% (1/1), 1.64 KiB | 0 bytes/s, done.
  45 Total 1 (delta 1), reused 0 (delta 0)
  46 remote: Resolving deltas: 100% (1/1), completed with 1 local objects.
  47 To https://github.com/whoeveryouare/qmk_firmware.git
  48  + 20043e64...7da94ac5 master -> master
  49 ```
  50
  51 现在你的改动已经在你Github上的分支中了 - 如果你回到这 (`https://github.com/你的GitHub账户名/qmk_firmware`) ,你可以点击下方所示按钮创建 "New Pull Request":
  52
  53 ![新的 Pull Request](http://i.imgur.com/DxMHpJ8.jpg)
  54
  55 现在你可以看到你所做的一切 - 如果看起来不错, 就可以点击 "Create Pull Request"定稿了:
  56
  57 ![创建Pull Request](http://i.imgur.com/Ojydlaj.jpg)
  58
  59 提交后,我们会开跟你说你的改动,要求您进行更改, 并最终接受您的更改!感谢您为QMK做的贡献 :)