GitHub, mis see on ja kuidas seda kasutada

GitHub on tarkvara, mida tarkvaraarenduse meeskonnad kasutavad laialdaselt arendusversioonide juhtimiseks.

See on kasulik, kui projekti kallal töötab rohkem kui üks inimene.

Oletagem näiteks, et tarkvaraarendajate meeskond soovib luua veebisaiti ja kõik peavad projektiga töötades koodi samal ajal värskendama. Sel juhul aitab Github luua tsentraliseeritud hoidla, kuhu igaüks saab programmikoodifaile üles laadida, redigeerida ja hallata.

Enne GitHubi kasutamise alustamist peate looma konto GitHub.

Hoidla

Hoidlat kasutatakse tavaliselt rakendustarkvara projekti korraldamiseks. Hoidlad võivad sisaldada kaustu ja faile, pilte, videoid, arvutustabeleid ja andmekogumeid – kõike, mida teie projekt vajab. Sageli sisaldavad hoidlad README-faili, faili, mis sisaldab teavet teie projekti kohta.

README-failid on kirjutatud Markdowni keeles lihttekstina. Võite konsulteerida See leht veebis Markdowni keele kiire viitena. GitHub võimaldab teil lisada README-faili samal ajal, kui loote uue hoidla. GitHub pakub ka muid levinud valikuid, näiteks litsentsifaili, kuid te ei pea neid esialgu valima.

Uue hoidla loomiseks valige paremas ülanurgas menüüst New repository. Jätkake järgmiste sammudega.

1. Kasutage mis tahes lehe paremas ülanurgas olevat rippmenüüd ja valige New repository.

1. Sisestage väljale Hoidla nimi first-repository.
2. Kirjutage väljale Kirjeldus lühike kirjeldus.
3. Valige Lisa README-fail.
4. Valige, kas teie hoidla on avalik või privaatne.
5. Vajuta siia Create repository.

Filiaali loomine

Haru loomine võimaldab teil hoida hoidlast korraga mitut versiooni.

Algseltdefinita, hoidla first-repository omab nimelist haru main mida peetakse haruks definitiiv. Saate luua hoidlas peamiseks täiendavaid filiaale first-repository. Filiaalide abil saate korraga omada projekti erinevaid versioone. See on kasulik, kui soovite lisada projektile uusi funktsioone ilma peamist lähtekoodi muutmata. Erinevatel harudel tehtud tööd ei kuvata põhiharus enne, kui selle ühendate. Saate kasutada filiaale katsetamiseks ja muudatuste tegemiseks enne nende sidumist põhivõrguga.

Kui loote põhiharust haru, teete koopia või hetktõmmise põhiharust, nagu see tol hetkel oli. Kui keegi teine ​​tegi põhiharus muudatusi, kui te oma haruga töötasite, võite need värskendused edasi lükata.

Järgmisel diagrammil näeme:

Peaharu
Uus filiaal helistas feature
Tee, mida feature toimib enne põhiga ühendamist

Uue rakenduse või veaparanduse jaoks haru loomine on nagu faili salvestamine. GitHubiga kasutavad tarkvaraarendajad harusid, et hoida veaparandusi ja funktsioonide tööd peamisest tootmisharust eraldi. Kui muudatus on valmis, liidetakse see põhiharuks.

Loome haru

Pärast hoidla loomist liikuge vahekaardile <>Code(1) hoidla:

Klõpsake põhimenüül (2) ja andke uuele nimi branch (3)

Kliki Create branch: first branch from 'main'

Nüüd on meil kaks branch, main e first-branch. Praegu näevad nad välja täpselt samasugused. Hiljem lisame muudatused uude branch.

Tehke ja kinnitage muudatused

Just lõi uue branch, GitHub tõi teid lehele code page uue jaoks first-branch, mis on põhifaili koopia.

Saame teha ja salvestada hoidlas olevates failides muudatusi. GitHubis kutsutakse salvestatud muudatusi välja commit. Iga commit on sõnumi saatjalt commit seotud, mis on kirjeldus, mis selgitab, miks konkreetne muudatus tehti. Sõnumid commit need jäädvustavad muudatuste ajalugu, et teised kaastöölised mõistaksid, mida ja miks tehti.

Oksa all first-branch loodud, klõpsake faili README.md ja seejärel faili redigeerimiseks pliiatsit.

Kirjutage redaktoris Markdowni abil.

Karbis Commit changes (Eelvaade), kirjutame sõnumi commit muudatusi kirjeldades.

Lõpuks klõpsake nuppu Commit changes.

Need muudatused tehakse ainult README-failis first-branch, seega sisaldab see haru põhiosast erinevat sisu.

Ühe avamine pull request

Nüüd, kui meil on põhiharus muudatusi, saame selle avada pull request.

Le pull request nad on GitHubi koostöö keskmes. Kui avate a pull request, pakute oma muudatusi ja palute kellelgi teha a review e pull oma panusest ja liita need oma harusse. The pull request näidata mõlema haru sisu erinevusi. Muudatused, liitmised ja lahutamised kuvatakse erinevate värvidega.

Kohe pärast kohustuse võtmist saate avada tõmbamistaotluse ja alustada arutelu, isegi enne koodi lõppu.

Funktsiooni kasutamine @mention GitHubi oma sõnumis pull request, saate küsida tagasisidet konkreetsetelt inimestelt või meeskondadelt, olenemata nende asukohast.

Võite isegi avada pull request oma hoidlas ja ühendage need ise. See on suurepärane võimalus õppida GitHubi voogu enne suuremate projektidega töötamist.

Ühe tegemiseks pull request sa pead:

• Klõpsake vahekaardil pull request teie hoidlast first-repository.

• Vajuta siia New pull request
• Kasti Example Comparisons, valige loodud haru, first-branch, võrrelda peaga (originaal).
• Vaadake oma erinevuste muudatused üle lehel Võrdle ja veenduge, et need on need, mida soovite esitada.

• Vajuta siia Create pull request.

• Andke omale pealkiri pull request kirjutage oma muudatustest lühike kirjeldus. Saate lisada emotikone ning pukseerida pilte ja GIF-e.

• Soovi korral klõpsake pealkirjast ja kirjeldusest paremal valikul Arvustajad. Saajad, sildid, projektid või verstapostid, et lisada mõni neist valikutest teie valikule pull request. Te ei pea neid veel lisama, kuid need valikud pakuvad mitmeid viise, kuidas teiega koostööd teha pull request.
• Vajuta siia Create pull request.

Teie kaastöötajad saavad nüüd teie muudatused üle vaadata ja soovitusi teha.

Ühendage oma pull request

Viimases etapis ühendate oma haru first-branch peaharus. Pärast ühendamist pull request, muudab filiaali first-branch manustatakse põhifaili.

Mõnikord võib tõmbepäring tuua sisse koodimuudatusi, mis on vastuolus põhivõrgu olemasoleva koodiga. Kui esineb konflikte, hoiatab GitHub teid vastuolulise koodi eest ja takistab liitmist, kuni konfliktid on lahendatud. Saate teha kohustuse, mis lahendab konfliktid, või kasutada tõmbetaotluse kommentaare, et arutada konflikte oma meeskonnaliikmetega.

• Vajuta siia Merge pull request muudatuste ühendamiseks peamiseks.

• Vajuta siia Confirm merge. Saate teate, et taotlus on edukalt ühendatud ja taotlus on suletud.
• Vajuta siia Delete branch. Nüüd, kui teie richiesta pull on ühendatud ja teie muudatused on põhirežiimis, võite filiaali ohutult kustutada first-branch. Kui soovite oma projektis täiendavaid muudatusi teha, saate alati luua uue haru ja korrata seda protsessi.

Ercole Palmeri