aboutsummaryrefslogtreecommitdiff
path: root/docs/he-il/getting_started_github.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/he-il/getting_started_github.md')
-rw-r--r--docs/he-il/getting_started_github.md69
1 files changed, 69 insertions, 0 deletions
diff --git a/docs/he-il/getting_started_github.md b/docs/he-il/getting_started_github.md
new file mode 100644
index 000000000..55602c814
--- /dev/null
+++ b/docs/he-il/getting_started_github.md
@@ -0,0 +1,69 @@
1<div dir="rtl" markdown="1">
2# איך להשתמש ב-Github עם QMK
3
4Github עלול להיות קצת טריקי למי שלא מכיר את העבודה איתו - מדריך זה ילווה אתכם שלב אחר שלב דרך ביצוע פעולות fork, clone ו-pull request עם QMK.
5
6?> מדריך זה מניח שאתם מרגישים בנוח עם הרצה של פקודות בסביבת command line (שורת הפקודה) ו-git מותקן במערכת שלכם.
7
8התחילו ב- [עמוד של QMK ב-Github](https://github.com/qmk/qmk_firmware), ותצמאו כפתור בחלק העליון מימין עם התיכוב "Fork":
9
10![Fork ב-Github](http://i.imgur.com/8Toomz4.jpg)
11
12אם אתם חלק מארגון, תצטרכו לבחור לאיזה חשבון לבצע פעולת fork. ברוב המבקרים, תרצו לבצע fork לתוך החשבון הפרטי שלכם. ברגע שה-fork הסתיים (לפעמים זה יכול לקחת קצת זמן) הקליקו על כפתור ה-"Clone or Download":
13
14![הורדה מ-Github](http://i.imgur.com/N1NYcSz.jpg)
15
16תוודאו שאתם בוחרים באופצייה של "HTTPS", בחרו את הקישור והעתיקו אותו:
17
18![קישור HTTPS](http://i.imgur.com/eGO0ohO.jpg)
19
20מכאן והלאה, הקיש `git clone ` בשורת הפקודה והדביקו את הלינק שלכם:
21
22<div dir="ltr" markdown="1">
23
24```
25user@computer:~$ git clone https://github.com/whoeveryouare/qmk_firmware.git
26Cloning into 'qmk_firmware'...
27remote: Counting objects: 46625, done.
28remote: Compressing objects: 100% (2/2), done.
29remote: Total 46625 (delta 0), reused 0 (delta 0), pack-reused 46623
30Receiving objects: 100% (46625/46625), 84.47 MiB | 3.14 MiB/s, done.
31Resolving deltas: 100% (29362/29362), done.
32Checking out files: 100% (2799/2799), done.
33```
34
35</div>
36
37כעת, יש לכם את ה-fork של QMK על המכונה המקומית שלכם ואתם יכולים להוסיף את מיפויי המקשים שלכם, לקמפל את הפרוייקט ולצרוב אותו על הלוח שלכם. כשאתם שלמים עם השינוי שעשיתם, תוכלו להוסיף, לבצע פעולת commit ולדחוף את השינויים ל-fork שלכם באופן הבא:
38
39<div dir="ltr" markdown="1">
40
41```
42user@computer:~$ git add .
43user@computer:~$ git commit -m "adding my keymap"
44[master cccb1608] adding my keymap
45 1 file changed, 1 insertion(+)
46 create mode 100644 keyboards/planck/keymaps/mine/keymap.c
47user@computer:~$ git push
48Counting objects: 1, done.
49Delta compression using up to 4 threads.
50Compressing objects: 100% (1/1), done.
51Writing objects: 100% (1/1), 1.64 KiB | 0 bytes/s, done.
52Total 1 (delta 1), reused 0 (delta 0)
53remote: Resolving deltas: 100% (1/1), completed with 1 local objects.
54To https://github.com/whoeveryouare/qmk_firmware.git
55 + 20043e64...7da94ac5 master -> master
56```
57
58</div>
59
60השינויים שלכם יופיעו ב-fork שלכם ב-GitHub - אם תחזרו לשם (`https://github.com/<whoeveryouare>/qmk_firmware`), תוכלו ליצור "Pull Request חדש" ע״י הקשה על הכפתור הבא:
61
62![Pull Request חדש](http://i.imgur.com/DxMHpJ8.jpg)
63
64כאן תוכלו לראות בדיוק למה עשיתם commit - אם הכל נראה תקין, תוכלו להשלים את הפעולה ע״י הקשה על "Create Pull Request":
65
66![צרו Pull Request](http://i.imgur.com/Ojydlaj.jpg)
67
68אחרי שהגשתם, אנו עלולים לפנות אליכם לגבי השינויים שהצעתם, נבקש שתבצעו שינויים ובסופו של דבר נקבל את השינויים! תודה שתרמתם לפרוייקט QMK :)
69</div> \ No newline at end of file