Ste že kdaj našli paket na GitHubu, ki ste ga uživali, vendar ste želeli dodati hitro funkcijo, odpraviti napako, ki ste jo našli, ali morda samo prispevati k odprtokodni kodi kot celoti? Pridružite se trendu socialnega kodiranja, delite svoje veščine in pomagajte izkoristiti odprtokodni svet. V tem članku se naučite vse o tem, kako prispevati kodo v repozitorij v GitHubu ali kateri koli goščeni storitvi git.
Pridobite namestitev
Ta članek predvideva, da že imate račun GitHub, če pa ne, prosim hitro registrirajte se za brezplačen račun. Prepričajte se tudi, da že imate git nameščen z zagonom naslednjega ukaza v terminalu:
git - različica
Če namesto številke različice prejmete sporočilo "ukaz ni najden", lahko namestite git z ukazom:
sudo apt-get -y namestite git
Razstavite skladišče
Najprej morate izbrati repozitorij, v katerega želite prispevati, in ga obiskati v svojem spletnem brskalniku. Če niste prepričani, katero skladišče izbrati, lahko uporabite predstavitveno skladišče, ki se nahaja na naslovu
https://github.com/mdizak/muo_demo. To je preprost demo in vabljeni ste, da zanj ustvarite vlečne zahteve za preizkušanje in učenje.Med ogledom repozitorija v spletnem brskalniku poiščite Odlagališče vilic in ga kliknite. S tem bo shramba razprta na vaš račun GitHub in vas pripeljala do nje. Nato morate kloniraj novo razčlenjeno skladišče, zato odprite terminal v lokalnem računalniku in zaženite:
Bi se radi spoznali s programsko opremo na GitHubu? Tukaj je opisano, kako se s poenostavljenim orodjem GitHub Desktop odpravite na vzhod.
klon git https://github.com/myusername/muo_demo.git
cd muo_demo
Seveda poskrbite, da boste zgornji URL spremenili v novega razdeljenega skladišča. Ko je klonirano, dodajte prvotni repozitorij kot upstream z ukazom:
git remote add upstream https://github.com/mdizak/muo_demo.git
Prepričajte se, da ste v zgornjem ukazu spremenili URL s prvotnim skladiščem, ki ste ga klonirali. To pomeni, da je git nadrejeni repozitorij, iz katerega delate.
Pripravite lokalno skladišče
Preden začnete delati na novem prispevku, se prepričajte, da uporabljate najnovejšo kodno osnovo nadrejenega repozitorija. V imeniku projekta v terminalu zaženite naslednje ukaze:
git checkout mojster
git pull upstream master && git push master master
Prvi ukaz zagotavlja, da trenutno delate v glavni veji, drugi ukaz pa sinhronizira nadrejeni repozitorij tako z lokalnimi kot z GitHub skladišči. To zagotavlja, da spreminjate najnovejšo osnovo kode in ne delate z zastarelo kodo.
Preverite tudi, ali ima projekt datoteko prispevati.md, in če je tako, se prepričajte, da sledite temu, kar piše. Včasih imajo projekti posebne smernice, kako prispevati prispevke, ki jih je treba vedno upoštevati.
Ustvari novo vejo
Ustvariti morate novo vejo, v kateri bodo vse spremembe tega prispevka, ki jih bodo vzdrževalci projekta pozneje združili v glavno repozitorij GitHub. Podružnica mora biti alfanumerična in jo lahko poimenujete poljubno.
Čeprav ni potrebno, se na splošno šteje za vljudno, če pred imenom imena podružnice dodate hitri popravek / za hitre popravke napak oz funkcija / za dodane funkcije. Izberite želeno ime veje in zaženite ukaz:
git checkout -b funkcija / my_cool_feature
Vedno morate ustvariti ločeno vejo za vsako funkcijo / popravek napake in nikoli ne vključiti več prispevkov v enega. To pomaga vzdrževati nemoten razvojni tok in pomaga zagotoviti, da je vaš prispevek sprejet in vključen v projekt.
Zdaj, ko je bila vaša veja ustvarjena, nadaljujte in dokončajte vse potrebne spremembe s standardnim delovnim tokom Git.
Zavežite in ustvarite zahtevo za vlečenje
Ko končate delo s svojim prispevkom, ga zavežite z pravilno sporočilo objave in ga z ukazi potisnite v svoje razčlenjeno skladišče:
git commit --file commit.txt
git push -u izvorna funkcija / my_cool_feature
Zadnji korak je ustvariti zahtevo za vlečenje, ki vzdrževalce projekta opozori, da čaka nov prispevek. V spletnem brskalniku obiščite razstavljeno repozitorij GitHub in videli boste spustni gumb, ki vam omogoča spreminjanje vej. Preklopite na novo ustvarjeno vejo in naslednja stran bo vsebovala povezavo, ki vam omogoča, da ustvarite novo zahtevo za vlečenje.
Ko kliknete to povezavo, boste videli stran, ki prikazuje vaše sporočilo o prevzemu in vse spremembe, ki ste jih naredili v kodi. Preglejte vse, da se prepričate, ali je pravilno, dodajte morebitna dodatna sporočila za vzdrževalce in oddajte zahtevo za vlečenje.
Še naprej prispevajte k GitHubu
Čestitamo, uspešno ste poslali prispevek k projektu GitHub!
Vaša zahteva za vlečenje zdaj čaka na pregled in odobritev s strani vzdrževalcev projekta, po e-pošti pa boste obveščeni, ali je bila odobrena, in z vsemi sporočili, ki jih imajo za vas. Zdaj, ko ste se naučili, kako prispevati k projektom na GitHubu, nadaljujte in pomagajte rasti odprtokodna skupnost.
Če telefon ali tablični računalnik Android deluje nekoliko počasi, bo morda potreboval le malo več RAM-a. Pri tem lahko pomagamo.
- Programiranje
- GitHub
Naročite se na naše novice
Pridružite se našemu glasilu za tehnične nasvete, preglede, brezplačne e-knjige in ekskluzivne ponudbe!
Še en korak…!
Potrdite svoj e-poštni naslov v e-poštnem sporočilu, ki smo vam ga pravkar poslali.