GitHub, kaj je in kako ga uporabljati

GitHub je programska oprema, ki jo pogosto uporabljajo skupine za razvoj programske opreme za nadzor razvojnih različic.

Uporabno je, ko na projektu dela več kot ena oseba.

Na primer, recimo, da skupina razvijalcev programske opreme želi zgraditi spletno stran in morajo vsi hkrati posodobiti kodo, medtem ko delajo na projektu. V tem primeru Github pomaga ustvariti centraliziran repozitorij, kamor lahko vsak nalaga, ureja in upravlja datoteke programske kode.

Preden začnete uporabljati GitHub, morate ustvariti račun GitHub.

Repozitorij

Repozitorij se običajno uporablja za organizacijo projekta aplikacijske programske opreme. Repozitoriji lahko vsebujejo mape in datoteke, slike, videoposnetke, preglednice in nize podatkov – vse, kar vaš projekt potrebuje. Repozitoriji pogosto vključujejo datoteko README, datoteko z informacijami o vašem projektu.

Datoteke README so napisane v jeziku Markdown v navadnem besedilu. Lahko se posvetujete ta stran splet kot hitra referenca jezika Markdown. GitHub vam omogoča dodajanje datoteke README hkrati z ustvarjanjem novega repozitorija. GitHub ponuja tudi druge pogoste možnosti, kot je licenčna datoteka, vendar vam na začetku ni treba izbrati nobene.

Če želite ustvariti nov repozitorij, zgoraj desno izberite v meniju New repository. Nadaljujte z naslednjimi koraki:

1. V zgornjem desnem kotu katere koli strani uporabite spustni meni in izberite New repository.

1. V polje Ime repozitorija vnesite first-repository.
2. V polje Opis napišite kratek opis.
3. Izberite Dodaj datoteko README.
4. Izberite, ali bo vaše skladišče javno ali zasebno.
5. Kliknite na Create repository.

Ustvarjanje veje

Ustvarjanje veje vam omogoča, da imate več različic repozitorija hkrati.

Privzetodefinita, skladišče first-repository ima imenovano vejo main ki velja za podružnico definitivno. Ustvarite lahko dodatne veje za glavne v repozitoriju first-repository. Veje lahko uporabite za istočasno uporabo različnih različic projekta. To je uporabno, če želite projektu dodati novo funkcionalnost, ne da bi spremenili glavno izvorno kodo. Delo, opravljeno na različnih vejah, ne bo prikazano na glavni veji, dokler je ne združite. Veje lahko uporabite za eksperimentiranje in spreminjanje, preden jih prenesete v main.

Ko ustvarite vejo iz glavne veje, naredite kopijo ali posnetek glavne veje, kakršna je bila v tistem trenutku. Če je nekdo drug naredil spremembe glavne veje, medtem ko ste delali na svoji veji, lahko potisnete te posodobitve.

V naslednjem diagramu lahko vidimo:

Glavna veja
Poklicana nova podružnica feature
Pot, ki jo feature izvede, preden se združi z glavnim

Ustvarjanje veje za novo izvedbo ali odpravljanje napak je kot shranjevanje datoteke. Z GitHubom razvijalci programske opreme uporabljajo podružnice, da ohranijo popravke napak in delo s funkcijami ločeno od glavne proizvodne veje. Ko je sprememba pripravljena, se združi v glavno vejo.

Ustvarimo vejo

Ko ustvarite naš repozitorij, se premaknite na zavihek <>Code(1) skladišča:

Kliknite glavni (2) spustni meni in nato poimenujte novega branch (3)

Kliknite na Create branch: first branch from 'main'

Zdaj imamo dva branch, main e first-branch. Trenutno sta videti popolnoma enaka. Kasneje bomo dodali spremembe v novo branch.

Izvedite in potrdite spremembe

Pravkar ustvaril novega branch, vas je GitHub pripeljal do code page za novo first-branch, ki je kopija main.

Spremembe datotek lahko naredimo in shranimo v repozitorij. Na GitHubu se pokličejo shranjene spremembe commit. Vsak commit ima sporočilo od commit povezan, kar je opis, ki pojasnjuje, zakaj je bila izvedena določena sprememba. Sporočila od commit zajemajo zgodovino sprememb, tako da lahko drugi sodelavci razumejo, kaj je bilo storjeno in zakaj.

Pod vejo first-branch kliknite na datoteko README.md in nato na svinčnik, da uredite datoteko.

V urejevalnik pišite z uporabo Markdown.

V škatli Commit changes (Predogled), napišemo sporočilo od commit opisovanje sprememb.

Na koncu kliknite na gumb Commit changes.

Te spremembe bodo izvedene samo v datoteki README first-branch, tako da zdaj ta veja vsebuje drugačno vsebino kot glavna.

Otvoritev enega pull request

Zdaj, ko imamo spremembe v glavni veji, jo lahko odpremo pull request.

Le pull request so srce sodelovanja na GitHubu. Ko odprete a pull request, predlagate svoje spremembe in zahtevate, da nekdo naredi a review e pull vašega prispevka in jih združiti v svojo vejo. The pull request pokažejo razlike v vsebini obeh vej. Spremembe, dodatki in odvzemi so prikazani v različnih barvah.

Takoj, ko se zavežete, lahko odprete zahtevo za vlečenje in začnete razpravo, še preden je koda končana.

Uporaba funkcije @mention GitHub v vašem sporočilu pull request, lahko za povratne informacije vprašate določene ljudi ali ekipe, ne glede na njihovo lokacijo.

Lahko celo odprete pull request v svojem skladišču in jih združite sami. To je odličen način, da se naučite toka GitHub, preden delate na večjih projektih.

Da bi naredil enega pull request moraš:

• Kliknite zavihek pull request vašega skladišča first-repository.

• Kliknite na New pull request
• V škatli Example Comparisons, izberite vejo, ki ste jo ustvarili, first-branch, primerjati z glavnim (izvirnikom).
• Preglejte svoje spremembe v razlikah na strani za primerjavo in se prepričajte, da so tiste, ki jih želite predložiti.

• Kliknite na Create pull request.

• Dajte svojemu naslov pull request napišite kratek opis svojih sprememb. Vključite lahko emojije ter povlečete in spustite slike in gif.

• Po želji lahko desno od naslova in opisa kliknete zraven Recenzenti. Prejemniki, oznake, projekti ali mejniki, da dodate katero koli od teh možnosti svojim pull request. Ni vam jih še treba dodati, vendar te možnosti ponujajo več načinov za sodelovanje z vašim pull request.
• Kliknite na Create pull request.

Vaši sodelavci lahko zdaj pregledajo vaše spremembe in podajo predloge.

Združi svoje pull request

V tem zadnjem koraku boste združili svojo vejo first-branch v glavni veji. Po združitvi pull request, spremembe podružnice first-branch bo vdelan v glavno datoteko.

Včasih lahko zahteva za vlečenje uvede spremembe kode, ki so v nasprotju z obstoječo kodo na main. Če pride do kakršnih koli sporov, vas bo GitHub opozoril na sporno kodo in preprečil spajanje, dokler konflikti niso razrešeni. Izvedete lahko potrditev, ki razreši spore, ali uporabite komentarje v zahtevi za vlečenje, da se o sporih pogovorite s člani svoje ekipe.

• Kliknite na Merge pull request da združite spremembe v glavno.

• Kliknite na Confirm merge. Prejeli boste sporočilo, da je bila zahteva uspešno združena in da je bila zahteva zaprta.
• Kliknite na Delete branch. Zdaj, ko je tvoj richiesta pull je združena in so vaše spremembe na glavni strani, lahko varno izbrišete vejo first-branch. Če želite še naprej spreminjati svoj projekt, lahko vedno ustvarite novo vejo in ponovite ta postopek.

Ercole Palmeri