You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

67 lines
3.5 KiB

  1. # QMK와 함께 Github를 사용하는 방법
  2. 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.
  3. Github는 자주 사용하는 사람이 아니면 좀 여려울수도 있습니다. 이 문서는 Github를 사용하는데 필요한 forking, cloning 그리고 submitting a pull request with QMK를 설명할 것입니다.
  4. ?> 이 가이드는 당신이 git커맨드를 사용하는데 익숙하고 git환경을 당신의 시스템이 설치하였다는 전제하에 작성되었습니다.
  5. 아래와 같이 [QMK Github 페이지](https://github.com/qmk/qmk_firmware)에서 당신은 "Fork"라고 쓰여있는 버튼을 볼 수 있습니다
  6. ![Fork on Github](https://i.imgur.com/8Toomz4.jpg)
  7. 만약 당신이 어느기관 소속이고, 무슨 계정을 사용할것인지 골라야 한다면 개인 계정을 사용하는 것을 추천합니다.
  8. "Fork"가 성공적으로 끝났다면 아래 보이는 "Clone or Download"를 눌러야 합니다.
  9. ![Download from Github](https://i.imgur.com/N1NYcSz.jpg)
  10. "HTTPS"채크 했는지 확인하고 나와 있는 링크를 복사하세요.
  11. ![HTTPS link](https://i.imgur.com/eGO0ohO.jpg)
  12. 여기거 부터 커맨드라인을 사용합니다. 커맨드 라인에서 `git clone `을 치고 복사한 링크를 붙여넣은후 실행시키세요.
  13. ```
  14. user@computer:~$ git clone https://github.com/whoeveryouare/qmk_firmware.git
  15. Cloning into 'qmk_firmware'...
  16. remote: Counting objects: 46625, done.
  17. remote: Compressing objects: 100% (2/2), done.
  18. remote: Total 46625 (delta 0), reused 0 (delta 0), pack-reused 46623
  19. Receiving objects: 100% (46625/46625), 84.47 MiB | 3.14 MiB/s, done.
  20. Resolving deltas: 100% (29362/29362), done.
  21. Checking out files: 100% (2799/2799), done.
  22. ```
  23. 당신은 이제 모든파일이 로컬시스템이 추가 되었습니다 그리고 이제 키맵을 추가하거나 컴파일, 프로그램 업로드(flashing)를 할 수 있습니다.
  24. 모든 추가 변경을 만든 뒤에는 add, commit, and push를 사용하여 당신의 Folk에 추가 할 수 있습니다.
  25. ```
  26. user@computer:~$ git add .
  27. user@computer:~$ git commit -m "adding my keymap"
  28. [master cccb1608] adding my keymap
  29. 1 file changed, 1 insertion(+)
  30. create mode 100644 keyboards/planck/keymaps/mine/keymap.c
  31. user@computer:~$ git push
  32. Counting objects: 1, done.
  33. Delta compression using up to 4 threads.
  34. Compressing objects: 100% (1/1), done.
  35. Writing objects: 100% (1/1), 1.64 KiB | 0 bytes/s, done.
  36. Total 1 (delta 1), reused 0 (delta 0)
  37. remote: Resolving deltas: 100% (1/1), completed with 1 local objects.
  38. To https://github.com/whoeveryouare/qmk_firmware.git
  39. + 20043e64...7da94ac5 master -> master
  40. ```
  41. 이로써 당신이 만든 모든 변경들이 당신의 Github의 Folk에 추가 되었습니다. (`https://github.com/<whoeveryouare>/qmk_firmware`)에서 확인하고 "New Pull Request"를 눌러 변경사항을 QMK에 업로드할수 있습니다.
  42. ![New Pull Request](https://i.imgur.com/DxMHpJ8.jpg)
  43. 이 버튼을 누르면 당신이 만든 모든 변경사항들이 보여질 것입니다. 만약 모든 변경사항이 맘에 든다면 "Create Pull Request"를 눌러 요청을 확정할수 있습니다.
  44. **요청사항이 확정된다고 변경사항이 바로 적용되는 것은 아닙니다.**
  45. ![Create Pull Request](https://i.imgur.com/Ojydlaj.jpg)
  46. 요청을 한뒤 QMK개발자들은 댓글로 무엇이 변경되었는지 등을 물어 볼수있지만 끝에는 매인 디랙토리로 업로드 될것입니다.
  47. **"Thanks for contributing to QMK :)"**