Nembo imeundwa kwa 💖 na CandidDeer
Je, ungependa kuwa mtunzaji wa mradi huu na kusaidia kuuendeleza? Ikiwa una nia, soma mwongozo wa maelezi , Jiunge na server yetu ya Discord au unitumie DM kwenye Twitter ili kuomba kujiunga na timu kutoka kwa waendeshaji wa mradi.
- Utangulizi
- Malengo
- Hii ni kwa ajili ya nani?
- Kwa nini ninahitaji kufanya hivi?
- Ninatarajia kuchangia nini?
- Tafsiri
- Usanidi!
- Changia
- Hatua ya 1: Gawa tena hifadhi hii
- Hatua ya 2: Clone hifadhi huu
- Hatua ya 3: Unda tawi jipya
- Hatua ya 4: Fungua faili ya index.html
- Hatua ya 5: Nakili templeti ya kadi
- Hatua ya 6: Tumia mabadiliko yako
- Hatua ya 7: Hifadhi mabadiliko yako
- Hatua ya 8: Chapisha mabadiliko yako kwenye GitHub
- Hatua ya 9: Wasilisha Ombi la Kuchangia
- Hatua ya 10: Sherehekea
- Hatua Zinazofuata
- Shukrani
- Leseni
- Wachangiaji Bora 100
Haya ni mafunzo ya kusaidia wachangiaji kwa mara ya kwanza kushiriki katika mradi rahisi na mwepesi.
- Toa mchango kwa mradi wa chanzo huru.
- Pata urahisi zaidi katika kutumia GitHub.
- Hii ni kwa wanaoanza kabisa. Ikiwa unajua jinsi ya kuandika na kuhariri lebo ya nanga
<a href="" target=""></a>basi unapaswa kuweza kuifanya. - Pia ni kwa wale walio na uzoefu zaidi lakini ambao wanataka kutoa mchango wao wa kwanza wa chanzo huria, au kupata michango zaidi kwa matumizi zaidi na kujiamini.
Msanidi programu yeyote wa wavuti, anayetarajia au mwenye uzoefu anahitaji kutumia udhibiti wa toleo la Git, na GitHub ndiyo huduma maarufu zaidi ya upangishaji wa Git inayotumiwa na kila mtu. Pia ni moyo wa jumuiya ya Open Source. Kupata starehe kwa kutumia GitHub ni ujuzi muhimu. Kutoa mchango kwenye mradi huongeza kujiamini kwako na hukupa kitu cha kuonyesha kwenye wasifu wako wa GitHub.
Ikiwa wewe ni msanidi programu mpya na unajiuliza ikiwa unahitaji kujifunza Git na GitHub basi jibu ndilo hili: Ulipaswa Kujifunza Git Jana.
Utachangia kadi kama hii kwa ukurasa wa wavuti wa mradi. Itajumuisha jina lako, mpini wako wa Twitter, maelezo mafupi, na viungo 3 vya nyenzo muhimu kwa wasanidi wa wavuti unaopendekeza.
Utafanya nakala ya kiolezo cha kadi ndani ya faili ya HTML na ukibinafsishe kwa maelezo yako mwenyewe.
Mafunzo haya pia yanapatikana katika lugha zingine
Tafsiri za hati za miradi zinakaribishwa. Soma
Mwongozo wa Tafsiriili kuchangia.
Kumbuka: Mafunzo haya yanatokana na GitHub PC. Ikiwa umeridhika na terminal nenda kwenye mafunzo haya (Bofya Hapa)
Kwanza tuweke mipangilio ya kufanya kazi
- Ingia kwenye akaunti yako ya GitHub. Ikiwa bado huna akaunti basi jiunge na GitHub. Ninapendekeza ufanye mafunzo ya GitHub Hello World kabla ya kuendelea.
- Pakua programu ya Kompyuta ya GitHub.
- Vinginevyo ikiwa uko vizuri kutumia Git kwenye safu ya amri unaweza kufanya hivyo Hiki hapa ni kiungo cha mafunzo ya CLI.
- Ukitumia Msimbo wa VS inakuja na Git iliyojumuishwa na hukuruhusu kufanya kile tunachohitaji moja kwa moja kutoka kwa kihariri.
- Walakini njia rahisi na rahisi zaidi ya kufuata mafunzo haya ni kutumia GitHub Desktop.
Sasa kwa kuwa wote mmeweka hebu tuendelee na shughuli ya kuchangia mradi.
Kuwa mchangiaji wa programu huria katika hatua 10 rahisi.
Muda uliokadiriwa: Chini ya dakika 30.
- Lengo hapa ni kutengeneza nakala ya mradi huu na kuiweka kwenye akaunti yako.
- Hifadhi (repo) ni jinsi mradi unavyoitwa kwenye GitHub na hua ni nakala yake.
- Hakikisha uko kwenye ukurasa mkuu ya repo hii.
 |
|---|
| Bofya kitufe cha Fork |
- Sasa una nakala kamili ya mradi katika akaunti yako mwenyewe.
- Sasa tunataka kufanya nakala ya ndani ya mradi. Hiyo ni nakala iliyohifadhiwa kwenye mashine yako mwenyewe.
- Fungua programu ya kompyuta ya GitHub. Katika programu:
 |
|---|
| Bofya Faili kisha Clone hazina |
- Utaona orodha ya miradi yako na forks kwenye GitHub.
- Chagua
<your-github-username>/Changia-Kwa-Hii-Mradi. - Bofya Clone
 |
|---|
| ↪️ Mradi uliogawiwa utakuwa na ishara ya kugawanywa kushoto. Mgawanyo wako utakuwa na mtumiaji wako wa GitHub yenyewe. |  |
|---|
- Hii itachukua muda kama mradi una nakiliwa kwenye diski yako kuu. Ninapendekeza uweke njia chaguo-msingi ambayo kawaida ni
..\Documents\GitHub. - Sasa una nakala ya ndani ya mradi.
- Mara tu repo imeundwa na kufunguliwa kwenye eneo-kazi la GitHub ni wakati wa kuunda tawi jipya.
- Tawi ni njia ya kuweka mabadiliko yako tofauti na sehemu kuu ya mradi inayoitwa
Master. Kwa mfano ikiwa mambo yataenda vibaya na haufurahii mabadiliko yako unaweza kufuta tawi na mradi mkuu hautaathiriwa.
↪️ bofya kwenye tawi la sasa, Kisha ubofye Mpya |
 |
|---|---|
↪️ Lipe tawi lako jina, kisha ubofye Unda tawi |
 |
| ↪️ Chapisha tawi lako jipya kwa GitHub |  |
- Unaweza kuitaja chochote unachotaka, lakini kwa kuwa hili ni tawi la kuongeza kadi yenye jina lako kwenye mradi, kuiita
jina-kadi yakoni mazoezi mazuri kwa sababu huweka nia ya tawi hili wazi. - Sasa umeunda tawi jipya tofauti na tawi la msingi.
- Kwa hatua zinazofuata hakikisha unafanya kazi katika tawi hili. Utaona jina la tawi ulilopo katikati ya juu ya programu ya eneo-kazi la GitHub ambapo inasema Tawi la sasa.
Usifanye kazi kwenye tawi la msingi
- Sasa tunahitaji kufungua faili tutakayohariri na kihariri chako cha msimbo unachopenda.
- Tafuta kabrasha ya mradi kwenye kompyuta yako. Ikiwa umeweka chaguo-msingi hii inapaswa kuwa kitu kama
kompyuta yako > Hati > GitHub > Changia-Kwa-Hii-Mradi - Faili ya
index.htmliko moja kwa moja kwenye kabrasha yaChangia-Kwa-Hii-Mradi. - Fungua kihariri chako cha msimbo (Sublime, VS Code, Atom...nk) na utumie amri ya
Fungua failina utafute faili ya index.html kwenye saraka kuu ya mradi.
 |
|---|
| ↪️ Vinginevyo unaweza kupata faili kwenye diski yako kuu, bofya kulia, na ufungue kwa kihariri chako |
- Sasa una faili utakayohariri wazi katika kihariri chako na uko tayari kuanza kuifanyia mabadiliko.
- Tutafanya nakala ya kiolezo cha kadi ili kuanza kuifanyia kazi
- Juu ya faili ya html, chini ya sehemu za
<head>na<header>utapata sehemu iliyoandikwa== TEMPLATE == - Nakili kila kitu ndani ya mraba nyekundu kwenye picha, kutoka kwa maoni ya
Kadi ya mchangiaji STARThadi maoni yaKadi ya mchangiaji END
 |
|---|
- Bandika jambo zima moja kwa moja chini ya maoni yanayoonyesha
- Hakikisha kuna mstari mmoja wa nafasi kati ya kuanza kwa kadi yako na mwisho wa kadi. Ni mazoezi mazuri kuweka msimbo wetu wazi iwezekanavyo
- Kamwe usitumie linters au fomati za mtindo. Mradi una usanidi wa Prettier
 |
|---|
- Hii sasa ni kadi yako utakayo binafsisha na kuhariri.
- Sasa tutaanza kuhariri html, kubadilisha sehemu zinazoweza kugeuzwa kukufaa kwenye kadi yetu.
| ↪️ Badilisha 'Jina' kwa jina lako |  |
|---|
- Kumbuka: Usibadilishe
class="jina"
↪️ Chomeka URL ya akaunti yako ya Twitter href="Ingiza URL hapa", Charaza mpini wako katika sehemu ya maandishi |
 |
|---|
- Ukipendelea kutumia mwasiliani isipokuwa Twitter utahitaji kubadilisha ikoni ya twitter
<i class="fa fa-x-twitter"></i>kwa kwenda kwa Icons Awesome Font inatafuta ikoni sahihi na kubadilisha sehemu yafa-x-twitterpekee na ikoni mpya kama vilefa-facebookkwa mfano. Kisha fuata hatua sawa hapo juu.
 |
|---|
| ↪️ Tuambie jambo kukuhusu. Weka fupi na tamu. Ifikirie zaidi kama tweet kuliko chapisho la blogi |
 |
| ↪️ Shiriki na jumuiya viungo 3 vya rasilimali ambazo ni muhimu kwa ukuzaji wa wavuti. Hii inaweza kuwa chochote, video, mazungumzo, podcast, makala, rerejea, au chombo. Ikiwa wewe ni mwanzilishi usiogopeshwe na hili, shiriki chochote unachokijua hata kama unaona ni cha msingi. Utashangaa ni watu wangapi watafaidika. |
- Kiungo: Weka kiungo
href="hapa"ukibadilisha#. Tafadhali epuka kutumia vifupisho vya URL au URL ambazo hazitoki kwenye tovuti unayochapisha! - Kichwa: Andika maelezo mafupi
title="hapa". - Jina: Andika jina la rasilimali katika sehemu ya maandishi
>hapa</a>. - Hakikisha kuwa umehifadhi mabadiliko yako yote.
- Jaribu mabadiliko yako. HII NI MUHIMU! Fungua faili ya html kwenye kivinjari chako (kwa kubofya mara mbili juu yake kwa mfano) na uone jinsi kadi yako itakavyokuwa kwenye tovuti. Tazama kwamba ukurasa mzima bado unaonekana sawa na hakuna chochote kilichovunjika. Bofya viungo vyako na uhakikishe kuwa vinafanya kazi. Fungua koni (Ctrl + Shift + J (Windows / Linux) au Cmd + Opt + J (Mac)) na uangalie kuwa hakuna ujumbe wa makosa.
- Sawa, umemaliza kuhariri nambari yako! Hatua zinazofuata zitatuma mabadiliko yako kwa GitHub na kisha kuyawasilisha ili yaunganishwe na mradi mkuu.
- Rudi kwenye programu ya kompyuta ya GitHub.
- Mabadiliko yako yatakuwa yameongezwa kiotomatiki kwenye eneo la jukwaa.
- Hii inamaanisha kuwa Git imerekodi mabadiliko yote yaliyohifadhiwa.
- Unaweza kuona hii yalijitokeza katika programu. Kila kitu ambacho umeongeza kwenye faili kitakuwa kijani, na ufutaji utaonekana kama nyekundu.
 |
|---|
↪️ Hatua inayofuata inaitwa Commit. Hii ina maana takriban thibitisha mabadiliko |
 |
↪️ Hivi ndivyo kichwa chako cha eneo-kazi cha GitHub kinapaswa kuonekana. Angalia alama ya uma karibu na jina la mradi katika Hazina ya Sasa, Tawi lako la Sasa litakuwa na jina uliloipa katika hatua ya 3 |
 |
↪️ Ili Kujitolea lazima ujaze sehemu ya Muhtasari. Huu ni ujumbe wa kujitolea unaoelezea kile umebadilisha. Katika kesi hii "Ongeza maelezo ya kadi yangu" itakuwa ujumbe unaofaa. Kwa hiari unaweza kuongeza Maelezo ya kina zaidi. Bofya kitufe cha Commit. Kitufe chako kitasema kitu kama Jitolee kwa "jina-tawi lako" |
- Mabadiliko yako sasa yamehifadhiwa au kutekelezwa. Lakini imehifadhiwa tu kwa eneo la ndani, hiyo ni kwenye kompyuta yako.
- Kusawazisha mabadiliko ya ndani na hazina yako kwenye GitHub inaitwa Push. "Unasukuma" mabadiliko kutoka kwa hazina yako ya karibu hadi hazina ya mbali kwenye GitHub.
↪️ Bofya kitufe cha Push |
 |
|---|
- Baada ya sekunde chache operesheni imekamilika na sasa unayo nakala sawa ya tawi hili kwenye mashine yako na vile vile kwenye GitHub.
- Huu ndio wakati ambao umekuwa ukingojea; kuwasilisha Ombi la Kuvuta (PR).
- Kufikia sasa kazi yote ambayo umefanya imekuwa kwenye mradi wa uma, ambao kama unavyokumbuka unakaa kwenye akaunti yako ya GitHub.
- Sasa ni wakati wa kutuma mabadiliko yako kwa mradi mkuu ili kuunganishwa nayo.
- Hii inaitwa Ombi la Kuvuta kwa sababu unauliza mtunza mradi asilia "kuvuta" mabadiliko yako kwenye mradi wao.
- Nenda kwenye ukurasa kuu wa fork yako kwenye GitHub (itakuwa na nembo ya uma na jina lako la mtumiaji hapo juu).
- Kuelekea juu ya repo utaona ujumbe wa ombi la kuvuta ulioangaziwa na kitufe cha kijani.
 |
|---|
↪️ Bofya kwenye Linganisha na kuvuta ombi |
 |
↪️ Hivi ndivyo ukurasa wa Fungua ombi la kuvuta unavyoonekana. |
- KUMBUKA unajaribu kuunganisha tawi lako na mradi asilia sio na
tawi la Msingikwenye fork yako. - Picha iliyo hapa chini inakupa wazo la jinsi kichwa cha ombi lako la kuvuta kinapaswa kuonekana kama.
- Upande wa kushoto ni mradi wa awali, ikifuatiwa na tawi kuu. Upande wa kulia ni fork yako na tawi ulilounda.
 |
|---|
↪️ Unda ombi la kuvuta: Andika kichwa, Ongeza maelezo ya hiari katika maelezo na Bofya Unda ombi la kuvuta |
- Usifadhaike na chaguzi zote. Unahitaji tu kufanya hatua hizi tatu kwa sasa.
- Acha chaguo la
Ruhusu uhariri kutoka kwa watunzajiumewekwa tiki. - Sasa, Ombi la Kuvuta litatumwa kwa msimamizi wa mradi. Mara tu itakapopitiwa na kukubaliwa mabadiliko yako yataonekana kwenye ukurasa wa wavuti wa mradi.
Ni hayo tu. Umefanya hivyo! Sasa umechangia kwenye chanzo huria kwenye GitHub.
Umeongeza msimbo kwenye ukurasa wa wavuti wa moja kwa moja: https://syknapse.github.io/Contribute-To-This-Project
Mabadiliko yako hayataonekana mara moja; kwanza zinapaswa kupitiwa, kukubaliwa, na kuunganishwa na mtunza mradi. Mara baada ya kuunganishwa kadi yako inapaswa kuonekana na kuishi kwenye ukurasa.
Ni kawaida sana kwa mhakiki kuomba mabadiliko kwenye PR. Ifikirie kama mazoezi mazuri ikiwa itatokea kwako. Fuatilia maoni na mabadiliko uliyoomba. Mara tu unapofanya mabadiliko yaliyoombwa (nyuma kwenye tawi lako) unachotakiwa kufanya ni kujitolea na kusukuma mabadiliko yako. PR itasasisha kiotomatiki na mabadiliko mapya.
Ninaahidi nitajaribu kukagua na kuunganisha haraka iwezekanavyo lakini ninafanya hivi kwa wakati wangu wa ziada, kwa hivyo kucheleweshwa kwa siku chache hakuwezi kuepukika.
- Rudi baada ya muda ili kuangalia Ombi lako la Kuvuta lililounganishwa.
- Unapaswa kupokea barua pepe kutoka kwa GitHub wakati mabadiliko yako yameidhinishwa, au ikiwa mabadiliko ya ziada yameombwa. Na wakati PR hatimaye imeunganishwa na bwana na kadi yako imeongezwa.
- Unaweza pia kujifunza jinsi ya kuchangia kutoka kwa mfululizo huu free: Jinsi ya Kuchangia Mradi wa Open Source kwenye GitHub
- Iwapo umepata mradi huu ni muhimu tafadhali upe ⭐ star ⭐ juu ya ukurasa na Tweet kuuhusu ili kusaidia kueneza neno
- Unaweza kunifuata na kuwasiliana nami kwa 𝕏 (Twitter) au kutumia mojawapo ya chaguo hizi nyingine
- Huu ni mradi wa programu huria kwa hivyo mbali na kuchangia kadi yako, unakaribishwa kukusaidia kurekebisha hitilafu, uboreshaji au vipengele vipya. Fungua suala au tuma ombi la changia /makala/kuunda-ombi-kuvuta-kutoka-uma/ 'Kuunda ombi la kuvuta kutoka kwa uma | Msaada wa GitHub')
- Ili kusaidia kuboresha jumuiya yetu, angalia kichupo cha GitHub Majadiliano kilicho karibu na Vuta Maombi. Eneo hili ni mahali pa kujitambulisha, kuingia katika majadiliano ya kina kuhusu Chanzo Huria, na kuwasiliana na Wasimamizi wa Mradi. Je, utatusaidia kujenganje ya kipengele hiki na kuboresha jumuiya yetu?
- Asante kwa kuchangia mradi huu. Sasa unaweza kuendelea na kujaribu kuchangia miradi mingine; tafuta
lebo kwa chaguo za michango zinazofaa kwa wanaoanza. - Pia ninatafuta washiriki wa kunisaidia katika kukagua na kuunganisha PR. Ikiwa ungependa kupata mazoezi ya hali ya juu zaidi ya Git soma mwongozo wa mtunzaji jiunge na server letu la Discord na kuomba kujiunga na timu kutoka kwa wasimamizi wa mradi.
Mradi huu umeathiriwa sana na mradi wa Roshan Jossey michango-ya-kwanza yenye mafunzo yake bora.
Pia imetiwa moyo hasa na jumuiya kuu inayozunguka #GoogleUdacityScholars The Google Challenge Scholarship: Front-End Web Dev, darasa la 2017 Ulaya.
Mradi huu umesajiliwa chini ya Leseni ya MIT.