18 KiB

Raw Permalink Blame History

Utangulizi wa GitHub

Somo hili linashughulikia misingi ya GitHub, jukwaa la kuhifadhi na kusimamia mabadiliko ya msimbo wako.

Sketchnote na Tomomi Imura

Jaribio Kabla ya Somo

Jaribio kabla ya somo

Utangulizi

Katika somo hili, tutajadili:

kufuatilia kazi unayofanya kwenye mashine yako
kufanya kazi kwenye miradi na wengine
jinsi ya kuchangia programu huria

Mahitaji ya Awali

Kabla ya kuanza, hakikisha Git imewekwa. Katika terminal andika: git --version

Ikiwa Git haijawekwa, pakua Git. Kisha, weka wasifu wako wa Git wa ndani kwenye terminal:

git config --global user.name "jina-lako"
git config --global user.email "barua-pepe-yako"

Ili kuthibitisha kama Git tayari imewekwa, unaweza kuandika: git config --list

Utahitaji pia akaunti ya GitHub, mhariri wa msimbo (kama Visual Studio Code), na ufungue terminal yako (au: command prompt).

Tembelea github.com na unda akaunti ikiwa bado huna, au ingia na ujaze wasifu wako.

✅ GitHub siyo hifadhi pekee ya msimbo duniani; kuna zingine, lakini GitHub ndiyo inayojulikana zaidi.

Maandalizi

Utahitaji folda yenye mradi wa msimbo kwenye mashine yako ya ndani (laptop au PC), na hifadhi ya umma kwenye GitHub, ambayo itatumika kama mfano wa jinsi ya kuchangia kwenye miradi ya wengine.

Usimamizi wa Msimbo

Tuseme una folda ya ndani yenye mradi wa msimbo na unataka kuanza kufuatilia maendeleo yako ukitumia git - mfumo wa kudhibiti matoleo. Watu wengine hulinganisha kutumia git na kuandika barua ya mapenzi kwa nafsi yako ya baadaye. Ukisoma ujumbe wako wa commit baada ya siku, wiki, au miezi, utaweza kukumbuka kwa nini ulifanya uamuzi fulani, au "kurudisha nyuma" mabadiliko - yaani, unapokuwa umeandika "commit messages" nzuri.

Kazi: Unda Hifadhi na Fanya Commit ya Msimbo

Tazama video

Unda hifadhi kwenye GitHub. Kwenye GitHub.com, katika kichupo cha hifadhi, au kutoka kwenye upau wa urambazaji wa juu-kulia, tafuta kitufe cha new repo.
1. Pea hifadhi yako jina
2. Chagua create repository.
Nenda kwenye folda yako ya kazi. Katika terminal yako, badilisha hadi kwenye folda (inayojulikana pia kama directory) unayotaka kuanza kufuatilia. Andika:
```
cd [name of your folder]
```
Anzisha hifadhi ya git. Katika mradi wako andika:
```
git init
```
Angalia hali. Ili kuangalia hali ya hifadhi yako andika:
```
git status
```
matokeo yanaweza kuonekana kama haya:
```
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)

     modified:   file.txt
     modified:   file2.txt
```
Kwa kawaida amri ya git status inakuambia vitu kama faili zipi ziko tayari kuhifadhiwa kwenye hifadhi au zina mabadiliko unayoweza kutaka kuhifadhi.
Ongeza faili zote kwa kufuatilia Hii pia inaitwa kuweka faili kwenye eneo la staging.
```
git add .
```
Amri ya git add pamoja na hoja ya . inaonyesha kuwa faili zako zote na mabadiliko yako yameongezwa kwa kufuatilia.
Ongeza faili zilizochaguliwa kwa kufuatilia
```
git add [file or folder name]
```
Hii inatusaidia kuongeza faili zilizochaguliwa tu kwenye eneo la staging wakati hatutaki kufanya commit ya faili zote mara moja.
Ondoa faili zote kutoka kwenye eneo la staging
```
git reset
```
Amri hii inatusaidia kuondoa faili zote kutoka kwenye eneo la staging mara moja.
Ondoa faili maalum kutoka kwenye eneo la staging
```
git reset [file or folder name]
```
Amri hii inatusaidia kuondoa faili maalum tu kutoka kwenye eneo la staging ambayo hatutaki kujumuisha kwenye commit inayofuata.
Hifadhi kazi yako. Kwa sasa umeongeza faili kwenye eneo linaloitwa staging area. Mahali ambapo Git inafuatilia faili zako. Ili kufanya mabadiliko yawe ya kudumu unahitaji commit faili hizo. Ili kufanya hivyo unaunda commit kwa amri ya git commit. Commit inawakilisha hatua ya kuhifadhi katika historia ya hifadhi yako. Andika yafuatayo kuunda commit:
```
git commit -m "first commit"
```
Hii inafanya commit ya faili zako zote, ikiongeza ujumbe "first commit". Kwa ujumbe wa commit wa baadaye utataka kuwa na maelezo zaidi ili kuelezea aina ya mabadiliko uliyofanya.
Unganisha hifadhi yako ya Git ya ndani na GitHub. Hifadhi ya Git ni nzuri kwenye mashine yako lakini wakati fulani utataka kuwa na nakala rudufu ya faili zako mahali pengine na pia kuwaalika watu wengine kufanya kazi na wewe kwenye hifadhi yako. Mahali pazuri pa kufanya hivyo ni GitHub. Kumbuka tayari tumeunda hifadhi kwenye GitHub kwa hivyo kitu pekee tunachohitaji kufanya ni kuunganisha hifadhi yetu ya Git ya ndani na GitHub. Amri ya git remote add itafanya hivyo. Andika amri ifuatayo:

Kumbuka, kabla ya kuandika amri nenda kwenye ukurasa wa hifadhi yako ya GitHub ili kupata URL ya hifadhi. Utaitumia kwenye amri hapa chini. Badilisha https://github.com/username/repository_name.git na URL yako ya GitHub.
```
git remote add origin https://github.com/username/repository_name.git
```
Hii inaunda remote, au muunganisho, unaoitwa "origin" unaoelekeza kwenye hifadhi ya GitHub uliyounda awali.
Tuma faili za ndani kwenda GitHub. Hadi sasa umeunda muunganisho kati ya hifadhi ya ndani na hifadhi ya GitHub. Hebu tutume faili hizi kwenda GitHub kwa amri ifuatayo git push, kama ifuatavyo:

Kumbuka, jina la tawi lako linaweza kuwa tofauti kwa chaguo-msingi kutoka main.
```
git push -u origin main
```
Hii inatuma commits zako kwenye tawi lako la "main" kwenda GitHub.
Kuongeza mabadiliko zaidi. Ikiwa unataka kuendelea kufanya mabadiliko na kuyasukuma kwenda GitHub utahitaji tu kutumia amri hizi tatu:
```
git add .
git commit -m "type your commit message here"
git push
```
Kidokezo, unaweza pia kutaka kutumia faili ya .gitignore ili kuzuia faili ambazo hutaki kufuatilia zisionekane kwenye GitHub - kama faili ya maelezo unayohifadhi kwenye folda hiyo hiyo lakini haina nafasi kwenye hifadhi ya umma. Unaweza kupata violezo vya faili za .gitignore kwenye .gitignore templates.

Ujumbe wa Commit

Mstari mzuri wa somo la commit ya Git unakamilisha sentensi ifuatayo: Ikiwa itatumika, commit hii itafanya

Kwa somo tumia hali ya amri, wakati wa sasa: "badilisha" siyo "ilibadilishwa" wala "inabadilisha". Kama ilivyo kwenye somo, kwenye mwili (hiari) pia tumia hali ya amri, wakati wa sasa. Mwili unapaswa kujumuisha motisha ya mabadiliko na kulinganisha haya na tabia ya awali. Unaelezea kwa nini, siyo jinsi.

✅ Chukua dakika chache kuvinjari GitHub. Je, unaweza kupata ujumbe wa commit mzuri sana? Je, unaweza kupata mmoja wa kiwango cha chini sana? Unafikiri ni taarifa gani muhimu zaidi na yenye manufaa kuwasilisha kwenye ujumbe wa commit?

Kazi: Kushirikiana

Sababu kuu ya kuweka vitu kwenye GitHub ilikuwa kufanya iwezekane kushirikiana na watengenezaji wengine.

Kufanya kazi kwenye miradi na wengine

Tazama video

Katika hifadhi yako, nenda kwenye Insights > Community ili kuona jinsi mradi wako unavyolinganishwa na viwango vya jamii vinavyopendekezwa.

Hapa kuna baadhi ya mambo yanayoweza kuboresha hifadhi yako ya GitHub:

Maelezo. Je, umeongeza maelezo kwa mradi wako?
README. Je, umeongeza README? GitHub inatoa mwongozo wa kuandika README.
Mwongozo wa kuchangia. Je, mradi wako una miongozo ya kuchangia?
Kanuni za Maadili. Kanuni za Maadili,
Leseni. Labda muhimu zaidi, leseni?

Rasilimali hizi zote zitafaidisha kuwaingiza wanachama wapya wa timu. Na haya ndiyo kwa kawaida mambo ambayo wachangiaji wapya huangalia kabla hata ya kuangalia msimbo wako, ili kujua kama mradi wako ni mahali sahihi kwao kutumia muda wao.

✅ Faili za README, ingawa zinachukua muda kuandaa, mara nyingi hupuuzwa na waangalizi wenye shughuli nyingi. Je, unaweza kupata mfano wa README iliyoelezea vizuri sana? Kumbuka: kuna baadhi ya zana za kusaidia kuunda README nzuri ambazo unaweza kupenda kujaribu.

Kazi: Unganisha msimbo fulani

Nyaraka za kuchangia husaidia watu kuchangia mradi. Inaelezea aina gani za michango unayotafuta na jinsi mchakato unavyofanya kazi. Wachangiaji watahitaji kupitia mfululizo wa hatua ili waweze kuchangia kwenye hifadhi yako kwenye GitHub:

Kufork hifadhi yako. Huenda utataka watu wafork mradi wako. Kufork kunamaanisha kuunda nakala ya hifadhi yako kwenye wasifu wao wa GitHub.
Clone. Kutoka hapo wata-clone mradi kwenye mashine yao ya ndani.
Unda tawi. Utataka kuwaomba waunde tawi kwa kazi yao.
Kuzingatia mabadiliko yao kwenye eneo moja. Waombe wachangiaji kuzingatia michango yao kwenye jambo moja kwa wakati mmoja - kwa njia hiyo nafasi za kuweza kuunganisha kazi yao ni kubwa zaidi. Fikiria wanaandika marekebisho ya hitilafu, kuongeza kipengele kipya, na kusasisha majaribio kadhaa - je, ikiwa unataka, au unaweza kutekeleza 2 kati ya 3, au 1 kati ya 3 mabadiliko?

✅ Fikiria hali ambapo matawi ni muhimu sana kwa kuandika na kusafirisha msimbo mzuri. Unaweza kufikiria matumizi gani?

Kumbuka, kuwa mabadiliko unayotaka kuona duniani, na uunde matawi kwa kazi yako mwenyewe pia. Commit yoyote unayofanya itafanywa kwenye tawi ambalo umefungua kwa sasa. Tumia git status kuona ni tawi gani hilo.

Hebu tupitie mtiririko wa kazi wa mchangiaji. Fikiria mchangiaji tayari ame-fork na clone hifadhi kwa hivyo wana hifadhi ya Git tayari kwa kufanyiwa kazi, kwenye mashine yao ya ndani:

Unda tawi. Tumia amri git branch kuunda tawi ambalo litajumuisha mabadiliko wanayokusudia kuchangia:
```
git branch [branch-name]
```
Badilisha hadi tawi la kazi. Badilisha hadi tawi maalum na usasishe folda ya kazi kwa git switch:
```
git switch [branch-name]
```
Fanya kazi. Kwa sasa unataka kuongeza mabadiliko yako. Usisahau kuijulisha Git kuhusu hilo kwa kutumia amri zifuatazo:
```
git add .
git commit -m "my changes"
```
Hakikisha unatoa commit jina zuri, kwa manufaa yako na pia kwa mwangalizi wa hifadhi unayosaidia.
Unganisha kazi yako na tawi la main. Wakati fulani unamaliza kazi na unataka kuunganisha kazi yako na ile ya tawi la main. Tawi la main linaweza kuwa limebadilika wakati huo kwa hivyo hakikisha kwanza unalisasisha hadi la hivi karibuni kwa amri zifuatazo:
```
git switch main
git pull
```
Kwa sasa unataka kuhakikisha kuwa mizozo yoyote, hali ambapo Git haiwezi kuunganisha mabadiliko kwa urahisi, inatokea kwenye tawi lako la kazi. Kwa hivyo tumia amri zifuatazo:
```
git switch [branch_name]
git merge main
```
Hii italeta mabadiliko yote kutoka main hadi kwenye tawi lako na tunatumaini unaweza kuendelea. Ikiwa sivyo, VS Code itakuonyesha mahali ambapo Git imechanganyikiwa na unarekebisha faili zilizoathiriwa ili kusema ni maudhui gani yaliyo sahihi zaidi.
Tuma kazi yako kwenda GitHub. Kutuma kazi yako kwenda GitHub kunamaanisha mambo mawili. Kusukuma tawi lako kwenye hifadhi yako na kisha kufungua PR, Pull Request.
```
git push --set-upstream origin [branch-name]
```
Amri hapo juu inaunda tawi kwenye hifadhi yako ya forked.
Fungua PR. Hatua inayofuata ni kufungua PR. Unaifanya kwa kwenda kwenye hifadhi ya forked kwenye GitHub. Utaona kiashiria kwenye GitHub kinachouliza ikiwa unataka kuunda PR mpya, bonyeza hiyo na utaelekezwa kwenye kiolesura ambapo unaweza kubadilisha kichwa cha ujumbe wa commit, ukape maelezo yanayofaa zaidi. Sasa mwangalizi wa hifadhi uliyofork ataona PR hii na vidole vimevukwa wataithamini na kuunganisha PR yako. Sasa wewe ni mchangiaji, hongera :)
Safisha. Inachukuliwa kuwa ni mazoea mazuri kusafisha baada ya kufanikiwa kuunganisha PR. Unataka kusafisha tawi lako la ndani na tawi ulilosukuma kwenda GitHub. Kwanza futa tawi hilo kwa ndani kwa amri ifuatayo:
```
git branch -d [branch-name]
```
Hakikisha unaenda kwenye ukurasa wa GitHub wa hifadhi ya forked na kuondoa tawi la mbali ulilosukuma kwenda. Pull request inaonekana kama neno la ajabu kwa sababu kwa kweli unataka kusukuma mabadiliko yako kwenye mradi. Lakini mhifadhi (mmiliki wa mradi) au timu ya msingi inahitaji kuzingatia mabadiliko yako kabla ya kuyachanganya na tawi kuu la mradi, kwa hivyo kwa kweli unaomba uamuzi wa mabadiliko kutoka kwa mhifadhi.

Pull request ni mahali pa kulinganisha na kujadili tofauti zilizotangulizwa kwenye tawi kwa kutumia maoni, hakiki, majaribio yaliyounganishwa, na zaidi. Pull request nzuri hufuata takriban sheria sawa na ujumbe wa commit. Unaweza kuongeza rejeleo kwa suala kwenye orodha ya masuala, kwa mfano ikiwa kazi yako inatatua suala fulani. Hii hufanyika kwa kutumia # ikifuatiwa na namba ya suala lako. Kwa mfano #97.

🤞Tunaomba dua kwamba majaribio yote yamefaulu na wamiliki wa mradi wanachanganya mabadiliko yako kwenye mradi🤞

Sasisha tawi lako la kazi la ndani na commit zote mpya kutoka kwenye tawi la mbali linalolingana kwenye GitHub:

git pull

Jinsi ya kuchangia kwenye chanzo huria

Kwanza, tafuta hifadhi (au repo) kwenye GitHub inayokuvutia na unayotaka kuchangia mabadiliko. Utataka kunakili yaliyomo kwenye mashine yako.

✅ Njia nzuri ya kupata hifadhi zinazofaa kwa wanaoanza ni kutafuta kwa alama 'good-first-issue'.

Kuna njia kadhaa za kunakili msimbo. Njia moja ni "kuzalisha" yaliyomo kwenye hifadhi, kwa kutumia HTTPS, SSH, au kutumia GitHub CLI (Command Line Interface).

Fungua terminal yako na zalisha hifadhi kama ifuatavyo: git clone https://github.com/ProjectURL

Ili kufanya kazi kwenye mradi, badilisha hadi kwenye folda sahihi: cd ProjectURL

Unaweza pia kufungua mradi mzima kwa kutumia Codespaces, mhariri wa msimbo wa GitHub uliojengwa ndani / mazingira ya maendeleo ya wingu, au GitHub Desktop.

Mwisho, unaweza kupakua msimbo katika folda iliyoshinikizwa (zipped).

Mambo machache ya kuvutia kuhusu GitHub

Unaweza kuweka alama ya nyota, kufuatilia, na/au "fork" hifadhi yoyote ya umma kwenye GitHub. Unaweza kupata hifadhi zako ulizoweka alama ya nyota kwenye menyu ya kushuka juu kulia. Ni kama kuweka alama ya kurasa, lakini kwa msimbo.

Miradi ina orodha ya masuala, mara nyingi kwenye GitHub katika kichupo cha "Issues" isipokuwa imeonyeshwa vinginevyo, ambapo watu hujadili masuala yanayohusiana na mradi. Na kichupo cha Pull Requests ni mahali ambapo watu hujadili na kukagua mabadiliko yanayoendelea.

Miradi inaweza pia kuwa na mijadala kwenye majukwaa, orodha za barua pepe, au njia za mazungumzo kama Slack, Discord au IRC.

✅ Angalia hifadhi yako mpya ya GitHub na ujaribu mambo kadhaa, kama kuhariri mipangilio, kuongeza taarifa kwenye hifadhi yako, na kuunda mradi (kama bodi ya Kanban). Kuna mengi unaweza kufanya!

🚀 Changamoto

Shirikiana na rafiki kufanya kazi kwenye msimbo wa kila mmoja. Unda mradi kwa pamoja, zalisha msimbo, unda matawi, na changanya mabadiliko.

Jaribio la Baada ya Somo

Jaribio la baada ya somo

Mapitio na Kujisomea

Soma zaidi kuhusu kuchangia kwenye programu huria.

Karatasi ya kumbukumbu ya Git.

Fanya mazoezi, mazoezi, mazoezi. GitHub ina njia nzuri za kujifunza zinazopatikana kupitia skills.github.com:

Wiki ya Kwanza kwenye GitHub

Pia utapata kozi za hali ya juu zaidi.

Kazi

Kamilisha kozi ya Wiki ya Kwanza kwenye GitHub

Kanusho:
Hati hii imetafsiriwa kwa kutumia huduma ya kutafsiri ya AI Co-op Translator. Ingawa tunajitahidi kuhakikisha usahihi, tafadhali fahamu kuwa tafsiri za kiotomatiki zinaweza kuwa na makosa au kutokuwa sahihi. Hati ya asili katika lugha yake ya awali inapaswa kuzingatiwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu ya binadamu inapendekezwa. Hatutawajibika kwa kutoelewana au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii.

18 KiB Raw Permalink Blame History