GitHub wat dit is en hoe om dit te gebruik

GitHub is 'n stuk sagteware wat wyd gebruik word deur sagteware-ontwikkelingspanne, vir ontwikkelingsweergawebeheer.

Dit is nuttig wanneer meer as een persoon aan 'n projek werk.

Gestel byvoorbeeld 'n span sagteware-ontwikkelaars wil 'n webwerf bou en hulle moet almal die kode gelyktydig opdateer terwyl hulle aan die projek werk. In hierdie geval help Github om 'n gesentraliseerde bewaarplek te skep waar almal programkodelêers kan oplaai, redigeer en bestuur.

Voordat jy GitHub begin gebruik, moet jy 'n rekening skep GitHub.

bewaarplek

'n Bewaarplek word gewoonlik gebruik om 'n toepassingsagtewareprojek te organiseer. Bewaarplekke kan dopgehou en lêers, beelde, video's, sigblaaie en datastelle bevat - alles wat jou projek benodig. Dikwels bevat bewaarplekke 'n README-lêer, 'n lêer met inligting oor jou projek.

README-lêers word in Markdown-taal in gewone teks geskryf. Jy kan konsulteer Hierdie bladsy web as 'n vinnige verwysing van die Markdown-taal. GitHub laat jou toe om 'n README-lêer by te voeg op dieselfde tyd as jy jou nuwe bewaarplek skep. GitHub bied ook ander algemene opsies soos 'n lisensielêer, maar jy hoef nie eers een te kies nie.

Om 'n nuwe bewaarplek te skep, kies regs bo in die kieslys New repository. Gaan voort met die volgende stappe:

1. Gebruik die aftreklys in die regter boonste hoek van enige bladsy en kies New repository.

1. Tik in die Bewaarpleknaam-boks in first-repository.
2. Skryf 'n kort beskrywing in die Beskrywing boks.
3. Kies Voeg 'n README-lêer by.
4. Kies of jou bewaarplek publiek of privaat sal wees.
5. Klik Create repository.

Die skep van 'n tak

Deur 'n tak te skep, kan jy verskeie weergawes van 'n bewaarplek op dieselfde tyd hê.

By verstekdefinita, die bewaarplek first-repository het 'n genoemde tak main wat as die tak beskou word definatief. U kan bykomende takke skep om in die bewaarplek te lei first-repository. Jy kan takke gebruik om verskillende weergawes van 'n projek op dieselfde tyd te hê. Dit is nuttig wanneer jy nuwe funksionaliteit by 'n projek wil voeg sonder om die hoofbronkode te verander. Werk wat op verskillende takke gedoen word, sal nie op die meestertak verskyn totdat jy dit saamsmelt nie. Jy kan takke gebruik om te eksperimenteer en veranderinge aan te bring voordat jy dit aan hoof verbind.

Wanneer jy 'n tak vanaf die hooftak skep, maak jy 'n kopie, of momentopname, van hoof soos dit op daardie oomblik was. As iemand anders veranderinge aan die hooftak gemaak het terwyl jy aan jou tak gewerk het, kan jy daardie opdaterings stoot.

In die volgende diagram kan ons sien:

Die hooftak
'n Nuwe tak genoem feature
Die pad wat die feature presteer voordat dit met hoof saamgevoeg word

Om 'n tak vir 'n nuwe implementering of foutoplossing te skep, is soos om 'n lêer te stoor. Met GitHub gebruik sagteware-ontwikkelaars takke om foutoplossings en kenmerkwerk apart van die hoofproduksietak te hou. Wanneer 'n verandering gereed is, word dit saamgevoeg in die hooftak.

Kom ons skep 'n tak

Nadat u ons bewaarplek geskep het, skuif na die oortjie <>Code(1) van die bewaarplek:

Klik op die hoof (2) aftreklys, en gee dan die nuwe een 'n naam branch (3)

Klik op Create branch: first branch from 'main'

Nou het ons twee branch, main e first-branch. Op die oomblik lyk hulle presies dieselfde. Later sal ons die veranderinge by die nuwe een voeg branch.

Maak en bevestig veranderinge

Sopas die nuwe een geskep branch, GitHub het jou na die code page vir die nuwe first-branch, wat 'n kopie van hoof is.

Ons kan veranderinge aan lêers in die bewaarplek maak en stoor. Op GitHub word gestoorde veranderinge genoem commit. Elkeen commit het 'n boodskap van commit geassosieer, wat 'n beskrywing is wat verduidelik waarom 'n spesifieke verandering aangebring is. Die boodskappe van commit hulle vang die geskiedenis van veranderinge vas sodat ander bydraers kan verstaan ​​wat gedoen is en hoekom.

Onder die tak first-branch geskep, klik op die README.md-lêer en dan op die potlood om die lêer te wysig.

Skryf in die redigeerder met Markdown.

In die kassie Commit changes (Voorskou), skryf ons 'n boodskap van commit die veranderinge te beskryf.

Klik uiteindelik op die knoppie Commit changes.

Hierdie veranderinge sal slegs aan die README-lêer gemaak word first-branch, so nou bevat hierdie tak ander inhoud as die hoof een.

Opening van een pull request

Noudat ons veranderinge in 'n hoofaftakking het, kan ons een oopmaak pull request.

Le pull request hulle is die hart van die samewerking op GitHub. Wanneer jy 'n oopmaak pull request, stel jy jou veranderinge voor en versoek iemand om 'n review e pull van jou bydrae en om hulle in hul tak saam te voeg. Die pull request wys die verskille van die inhoud van beide takke. Veranderinge, optellings en aftrekkings word in verskillende kleure getoon.

Sodra jy 'n commit maak, kan jy 'n trekversoek oopmaak en 'n bespreking begin, selfs voordat die kode klaar is.

Gebruik die funksie @mention van GitHub in jou boodskap van pull request, kan jy spesifieke mense of spanne vir terugvoer vra, ongeag hul ligging.

Jy kan selfs oopmaak pull request in jou bewaarplek en voeg dit self saam. Dit is 'n goeie manier om die GitHub-stroom te leer voordat u aan groter projekte werk.

Om een ​​te maak pull request jy moet:

• Klik op die blad pull request van jou bewaarplek first-repository.

• Klik New pull request
• In die boks Example Comparisons, kies die tak wat jy geskep het, first-branch, om met hoof (die oorspronklike) vergelyk te word.
• Hersien jou veranderinge in die verskille op die Vergelyk-bladsy, maak seker dit is dié wat jy wil indien.

• Klik Create pull request.

• Gee joune 'n titel pull request skryf 'n kort beskrywing van jou veranderinge. Jy kan emoji's insluit en prente en gif's sleep en laat val.

• Opsioneel, regs van die titel en beskrywing, klik langs Beoordelaars. Ontvangers, etikette, projekte of mylpale om enige van hierdie opsies by joune te voeg pull request. Jy hoef dit nog nie by te voeg nie, maar hierdie opsies bied verskeie maniere om saam te werk met jou pull request.
• Klik Create pull request.

Jou medewerkers kan nou jou veranderinge nagaan en voorstelle maak.

Voeg joune saam pull request

In hierdie laaste stap sal jy jou tak saamvoeg first-branch in die hooftak. Na die samesmelting van die pull request, veranderinge aan die tak first-branch sal in die hooflêer ingebed word.

Soms kan 'n trekversoek kodeveranderings instel wat bots met bestaande kode op hoof. As daar enige konflikte is, sal GitHub jou waarsku oor die botsende kode en die samesmelting verhoed totdat die konflikte opgelos is. Jy kan 'n verbintenis maak wat die konflikte oplos of die opmerkings in die trekversoek gebruik om die konflikte met jou spanlede te bespreek.

• Klik Merge pull request om die veranderinge in hoof te voeg.

• Klik Confirm merge. Jy sal 'n boodskap ontvang dat die versoek suksesvol saamgevoeg is en die versoek gesluit is.
• Klik Delete branch. Nou dat jou richiesta pull saamgevoeg is en jou veranderinge op hoof is, kan jy die tak veilig uitvee first-branch. As jy verdere veranderinge aan jou projek wil maak, kan jy altyd 'n nuwe tak skep en hierdie proses herhaal.

Ercole Palmeri