GitHub kas tai yra ir kaip juo naudotis

„GitHub“ yra programinės įrangos dalis, kurią plačiai naudoja programinės įrangos kūrimo komandos, skirtos kūrimo versijos valdymui.

Tai naudinga, kai prie projekto dirba daugiau nei vienas žmogus.

Pavyzdžiui, tarkime, kad programinės įrangos kūrėjų komanda nori sukurti svetainę ir jie visi turi atnaujinti kodą tuo pačiu metu, kai dirba su projektu. Šiuo atveju „Github“ padeda sukurti centralizuotą saugyklą, kurioje kiekvienas gali įkelti, redaguoti ir valdyti programos kodo failus.

Prieš pradėdami naudoti „GitHub“, turite susikurti paskyrą GitHub.

Saugykla

Saugykla dažniausiai naudojama programinės įrangos projektui organizuoti. Saugyklose gali būti aplankų ir failų, vaizdų, vaizdo įrašų, skaičiuoklių ir duomenų rinkinių – visko, ko reikia jūsų projektui. Dažnai saugyklose yra README failas, failas su informacija apie jūsų projektą.

README failai parašyti Markdown kalba paprastu tekstu. Galite pasikonsultuoti Šitas puslapis žiniatinklį kaip greitą Markdown kalbos nuorodą. „GitHub“ leidžia pridėti README failą tuo pačiu metu, kai kuriate naują saugyklą. „GitHub“ taip pat siūlo kitas įprastas parinktis, pvz., licencijos failą, tačiau iš pradžių jų pasirinkti nereikia.

Norėdami sukurti naują saugyklą, viršuje dešinėje pasirinkite meniu New repository. Atlikite šiuos veiksmus:

1. Viršutiniame dešiniajame bet kurio puslapio kampe naudokite išskleidžiamąjį meniu ir pasirinkite New repository.

1. Lauke Saugyklos pavadinimas įveskite first-repository.
2. Aprašymo laukelyje parašykite trumpą aprašymą.
3. Pasirinkite Pridėti README failą.
4. Pasirinkite, ar jūsų saugykla bus vieša, ar privati.
5. Spustelėkite ant Create repository.

Filialo kūrimas

Sukūrę filialą, vienu metu galite turėti kelias saugyklos versijas.

Pagal numatytuosius nustatymusdefinita, saugykla first-repository turi pavadintą filialą main kuri laikoma šaka definitive. Saugykloje galite sukurti papildomų šakų first-repository. Galite naudoti filialus, norėdami vienu metu turėti skirtingas projekto versijas. Tai naudinga, kai norite pridėti naujų funkcijų prie projekto nekeičiant pagrindinio šaltinio kodo. Darbas, atliktas skirtingose ​​šakose, nebus rodomas pagrindinėje šakoje, kol jos nesujungsite. Galite naudoti filialus eksperimentuoti ir atlikti pakeitimus prieš įtraukdami juos į pagrindinį.

Kai kuriate šaką iš pagrindinės šakos, darote pagrindinės atšakos kopiją arba momentinę kopiją, kuri buvo tuo metu. Jei kas nors kitas atliko pagrindinio filialo pakeitimus, kol jūs dirbote su savo šaka, galite siųsti tuos naujinimus.

Šioje diagramoje matome:

Pagrindinė šaka
Paskambino naujas filialas feature
Kelias, kurį feature atlieka prieš sujungiant su pagrindine

Filialo kūrimas naujam diegimui arba klaidų taisymui prilygsta failo išsaugojimui. Naudodami „GitHub“, programinės įrangos kūrėjai naudoja filialus, kad pataisytų klaidas ir veiktų atskirai nuo pagrindinės gamybos šakos. Kai pakeitimas yra paruoštas, jis sujungiamas į pagrindinę šaką.

Sukurkime filialą

Sukūrę saugyklą, pereikite prie skirtuko <>Code(1) iš saugyklos:

Spustelėkite pagrindinį (2) išskleidžiamąjį meniu, tada pavadinkite naująjį branch (3)

Spustelėkite Create branch: first branch from 'main'

Dabar turime du branch, main e first-branch. Šiuo metu jie atrodo lygiai taip pat. Vėliau pakeitimus įtrauksime į naują branch.

Atlikite ir patvirtinkite pakeitimus

Ką tik sukūrė naują branch, „GitHub“ atvedė jus į code page už naujus first-branch, kuri yra pagrindinės.

Galime atlikti ir išsaugoti saugykloje esančių failų pakeitimus. „GitHub“ iškviečiami išsaugoti pakeitimai commit. Kiekvienas commit turi pranešimą nuo commit susijęs, tai yra aprašymas, paaiškinantis, kodėl buvo atliktas konkretus pakeitimas. Pranešimai apie commit juose užfiksuota pokyčių istorija, kad kiti bendradarbiai suprastų, kas buvo padaryta ir kodėl.

Po šaka first-branch sukurtą, spustelėkite README.md failą, tada – pieštuką, kad redaguotumėte failą.

Redagavimo priemonėje rašykite naudodami Markdown.

Dėžutėje Commit changes (Peržiūra), rašome žinutę commit aprašant pokyčius.

Galiausiai spustelėkite mygtuką Commit changes.

Šie pakeitimai bus atlikti tik README faile first-branch, todėl dabar šioje šakoje yra kitoks turinys nei pagrindinėje.

Vieno atidarymas pull request

Dabar, kai turime pakeitimų pagrindinėje šakoje, galime jį atidaryti pull request.

Le pull request jie yra bendradarbiavimo GitHub centre. Kai atidarote a pull request, jūs siūlote savo pakeitimus ir prašote, kad kas nors padarytų a review e pull jūsų indėlio ir sujungti juos į savo filialą. The pull request parodyti abiejų šakų turinio skirtumus. Pakeitimai, papildymai ir atimtys rodomi skirtingomis spalvomis.

Kai tik padarysite įsipareigojimą, galite atidaryti ištraukimo užklausą ir pradėti diskusiją net prieš baigiant kodą.

Naudojant funkciją @mention „GitHub“ pranešime pull request, galite paprašyti konkrečių žmonių ar komandų atsiliepimų, neatsižvelgiant į jų vietą.

Jūs netgi galite atidaryti pull request savo saugykloje ir patys juos sujunkite. Tai puikus būdas išmokti naudotis GitHub srautu prieš pradedant dirbti su didesniais projektais.

Padaryti vieną pull request tu privalai:

• Spustelėkite skirtuką pull request savo saugyklos first-repository.

• Spustelėkite ant New pull request
• Dėžėje Example Comparisons, pasirinkite sukurtą filialą, first-branch, palyginti su pagrindiniu (originalu).
• Peržiūrėkite skirtumų pakeitimus puslapyje Palyginti ir įsitikinkite, kad jie yra tie, kuriuos norite pateikti.

• Spustelėkite ant Create pull request.

• Suteik savo titulą pull request parašykite trumpą savo pakeitimų aprašymą. Galite įtraukti jaustukus ir nuvilkti vaizdus bei GIF.

• Pasirinktinai, pavadinimo ir aprašo dešinėje spustelėkite šalia Recenzentai. Gavėjai, etiketės, projektai ar etapai, kad pridėtumėte bet kurią iš šių parinkčių prie savo pull request. Jums dar nereikia jų pridėti, tačiau šios parinktys siūlo keletą būdų bendradarbiauti naudojant savo pull request.
• Spustelėkite ant Create pull request.

Dabar jūsų bendradarbiai gali peržiūrėti pakeitimus ir teikti pasiūlymus.

Sujunkite savo pull request

Šiame paskutiniame etape sujungsite savo filialą first-branch pagrindinėje šakoje. Sujungus pull request, keičiasi šaka first-branch bus įterptas į pagrindinį failą.

Kartais ištraukimo užklausa gali pakeisti kodą, kuris prieštarauja esamam pagrindiniam kodui. Jei kils kokių nors konfliktų, „GitHub“ įspės apie nesuderinamą kodą ir neleis sujungti, kol konfliktai bus išspręsti. Galite įsipareigoti, kad išspręstų konfliktus, arba naudoti komentarus ištraukimo užklausoje, kad aptartumėte konfliktus su savo komandos nariais.

• Spustelėkite ant Merge pull request kad pakeitimai būtų sujungti į pagrindinius.

• Spustelėkite ant Confirm merge. Gausite pranešimą, kad užklausa sėkmingai sujungta ir užklausa uždaryta.
• Spustelėkite ant Delete branch. Dabar, kai tavo richiesta pull yra sujungtas ir jūsų pakeitimai yra pagrindiniai, galite saugiai ištrinti šaką first-branch. Jei norite atlikti tolesnius projekto pakeitimus, visada galite sukurti naują filialą ir pakartoti šį procesą.

Ercole Palmeri