qmk_firmware/he-il/getting_started_github.md

76 lines
4.1 KiB
Markdown
Raw Normal View History

<div dir="rtl" markdown="1">
# ืื™ืš ืœื”ืฉืชืžืฉ ื‘-GitHub ืขื QMK
GitHub ืขืœื•ืœ ืœื”ื™ื•ืช ืงืฆืช ื˜ืจื™ืงื™ ืœืžื™ ืฉืœื ืžื›ื™ืจ ืืช ื”ืขื‘ื•ื“ื” ืื™ืชื• - ืžื“ืจื™ืš ื–ื” ื™ืœื•ื•ื” ืืชื›ื ืฉืœื‘ ืื—ืจ ืฉืœื‘ ื“ืจืš ื‘ื™ืฆื•ืข ืคืขื•ืœื•ืช fork, clone ื•-pull request ืขื QMK.
?> ืžื“ืจื™ืš ื–ื” ืžื ื™ื— ืฉืืชื ืžืจื’ื™ืฉื™ื ื‘ื ื•ื— ืขื ื”ืจืฆื” ืฉืœ ืคืงื•ื“ื•ืช ื‘ืกื‘ื™ื‘ืช command line (ืฉื•ืจืช ื”ืคืงื•ื“ื”) ื•-git ืžื•ืชืงืŸ ื‘ืžืขืจื›ืช ืฉืœื›ื.
ื”ืชื—ื™ืœื• ื‘- [ืขืžื•ื“ ืฉืœ QMK ื‘-GitHub](https://github.com/qmk/qmk_firmware), ื•ืชืฆืžืื• ื›ืคืชื•ืจ ื‘ื—ืœืง ื”ืขืœื™ื•ืŸ ืžื™ืžื™ืŸ ืขื ื”ืชื™ื›ื•ื‘ "Fork":
![Fork ื‘-GitHub](http://i.imgur.com/8Toomz4.jpg)
ืื ืืชื ื—ืœืง ืžืืจื’ื•ืŸ, ืชืฆื˜ืจื›ื• ืœื‘ื—ื•ืจ ืœืื™ื–ื” ื—ืฉื‘ื•ืŸ ืœื‘ืฆืข ืคืขื•ืœืช fork. ื‘ืจื•ื‘ ื”ืžื‘ืงืจื™ื, ืชืจืฆื• ืœื‘ืฆืข fork ืœืชื•ืš ื”ื—ืฉื‘ื•ืŸ ื”ืคืจื˜ื™ ืฉืœื›ื. ื‘ืจื’ืข ืฉื”-fork ื”ืกืชื™ื™ื (ืœืคืขืžื™ื ื–ื” ื™ื›ื•ืœ ืœืงื—ืช ืงืฆืช ื–ืžืŸ) ื”ืงืœื™ืงื• ืขืœ ื›ืคืชื•ืจ ื”-"Clone or Download":
![ื”ื•ืจื“ื” ืž-GitHub](http://i.imgur.com/N1NYcSz.jpg)
ืชื•ื•ื“ืื• ืฉืืชื ื‘ื•ื—ืจื™ื ื‘ืื•ืคืฆื™ื™ื” ืฉืœ "HTTPS", ื‘ื—ืจื• ืืช ื”ืงื™ืฉื•ืจ ื•ื”ืขืชื™ืงื• ืื•ืชื•:
![ืงื™ืฉื•ืจ HTTPS](http://i.imgur.com/eGO0ohO.jpg)
ืžื›ืืŸ ื•ื”ืœืื”, ื”ืงื™ืฉ `git clone --recurse-submodules ` ื‘ืฉื•ืจืช ื”ืคืงื•ื“ื” ื•ื”ื“ื‘ื™ืงื• ืืช ื”ืœื™ื ืง ืฉืœื›ื:
<div dir="ltr" markdown="1">
```
user@computer:~$ git clone --recurse-submodules https://github.com/whoeveryouare/qmk_firmware.git
Cloning into 'qmk_firmware'...
remote: Enumerating objects: 9, done.
remote: Counting objects: 100% (9/9), done.
remote: Compressing objects: 100% (5/5), done.
remote: Total 183883 (delta 5), reused 4 (delta 4), pack-reused 183874
Receiving objects: 100% (183883/183883), 132.90 MiB | 9.57 MiB/s, done.
Resolving deltas: 100% (119972/119972), done.
...
Submodule path 'lib/chibios': checked out '587968d6cbc2b0e1c7147540872f2a67e59ca18b'
Submodule path 'lib/chibios-contrib': checked out 'ede48346eee4b8d6847c19bc01420bee76a5e486'
Submodule path 'lib/googletest': checked out 'ec44c6c1675c25b9827aacd08c02433cccde7780'
Submodule path 'lib/lufa': checked out 'ce10f7642b0459e409839b23cc91498945119b4d'
Submodule path 'lib/ugfx': checked out '3e97b74e03c93631cdd3ddb2ce43b963fdce19b2'
```
</div>
ื›ืขืช, ื™ืฉ ืœื›ื ืืช ื”-fork ืฉืœ QMK ืขืœ ื”ืžื›ื•ื ื” ื”ืžืงื•ืžื™ืช ืฉืœื›ื ื•ืืชื ื™ื›ื•ืœื™ื ืœื”ื•ืกื™ืฃ ืืช ืžื™ืคื•ื™ื™ ื”ืžืงืฉื™ื ืฉืœื›ื, ืœืงืžืคืœ ืืช ื”ืคืจื•ื™ื™ืงื˜ ื•ืœืฆืจื•ื‘ ืื•ืชื• ืขืœ ื”ืœื•ื— ืฉืœื›ื. ื›ืฉืืชื ืฉืœืžื™ื ืขื ื”ืฉื™ื ื•ื™ ืฉืขืฉื™ืชื, ืชื•ื›ืœื• ืœื”ื•ืกื™ืฃ, ืœื‘ืฆืข ืคืขื•ืœืช commit ื•ืœื“ื—ื•ืฃ ืืช ื”ืฉื™ื ื•ื™ื™ื ืœ-fork ืฉืœื›ื ื‘ืื•ืคืŸ ื”ื‘ื:
<div dir="ltr" markdown="1">
```
user@computer:~$ git add .
user@computer:~$ git commit -m "adding my keymap"
[master cccb1608] adding my keymap
1 file changed, 1 insertion(+)
create mode 100644 keyboards/planck/keymaps/mine/keymap.c
user@computer:~$ git push
Counting objects: 1, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (1/1), done.
Writing objects: 100% (1/1), 1.64 KiB | 0 bytes/s, done.
Total 1 (delta 1), reused 0 (delta 0)
remote: Resolving deltas: 100% (1/1), completed with 1 local objects.
To https://github.com/whoeveryouare/qmk_firmware.git
+ 20043e64...7da94ac5 master -> master
```
</div>
ื”ืฉื™ื ื•ื™ื™ื ืฉืœื›ื ื™ื•ืคื™ืขื• ื‘-fork ืฉืœื›ื ื‘-GitHub - ืื ืชื—ื–ืจื• ืœืฉื (`https://github.com/<whoeveryouare>/qmk_firmware`), ืชื•ื›ืœื• ืœื™ืฆื•ืจ "Pull Request ื—ื“ืฉ" ืขืดื™ ื”ืงืฉื” ืขืœ ื”ื›ืคืชื•ืจ ื”ื‘ื:
![Pull Request ื—ื“ืฉ](http://i.imgur.com/DxMHpJ8.jpg)
ื›ืืŸ ืชื•ื›ืœื• ืœืจืื•ืช ื‘ื“ื™ื•ืง ืœืžื” ืขืฉื™ืชื commit - ืื ื”ื›ืœ ื ืจืื” ืชืงื™ืŸ, ืชื•ื›ืœื• ืœื”ืฉืœื™ื ืืช ื”ืคืขื•ืœื” ืขืดื™ ื”ืงืฉื” ืขืœ "Create Pull Request":
![ืฆืจื• Pull Request](http://i.imgur.com/Ojydlaj.jpg)
ืื—ืจื™ ืฉื”ื’ืฉืชื, ืื ื• ืขืœื•ืœื™ื ืœืคื ื•ืช ืืœื™ื›ื ืœื’ื‘ื™ ื”ืฉื™ื ื•ื™ื™ื ืฉื”ืฆืขืชื, ื ื‘ืงืฉ ืฉืชื‘ืฆืขื• ืฉื™ื ื•ื™ื™ื ื•ื‘ืกื•ืคื• ืฉืœ ื“ื‘ืจ ื ืงื‘ืœ ืืช ื”ืฉื™ื ื•ื™ื™ื! ืชื•ื“ื” ืฉืชืจืžืชื ืœืคืจื•ื™ื™ืงื˜ QMK :)
</div>