GitHub wat it is en hoe it te brûken

GitHub is in stik software dat in soad brûkt wurdt troch softwareûntwikkelingsteams, foar kontrôleferzje fan ûntwikkeling.

It is handich as mear as ien persoan wurket oan in projekt.

Stel, bygelyks, in team fan software-ûntwikkelders wol in webside bouwe en se moatte allegear de koade bywurkje, tagelyk, wylst se wurkje oan it projekt. Yn dit gefal helpt Github in sintralisearre repository te meitsjen wêr't elkenien programmakoadebestannen uploade, bewurkje en beheare kin.

Foardat jo GitHub begjinne te brûken, moatte jo in akkount oanmeitsje GitHub.

Repository

In repository wurdt normaal brûkt om in applikaasjesoftwareprojekt te organisearjen. Repositories kinne mappen en bestannen, ôfbyldings, fideo's, spreadsheets en datasets befetsje - alles wat jo projekt nedich is. Faak befetsje repositories in README-bestân, in bestân mei ynformaasje oer jo projekt.

README-bestannen wurde skreaun yn Markdown-taal yn platte tekst. Jo kinne rieplachtsje Dizze side web as rappe referinsje fan 'e Markdown-taal. GitHub lit jo in README-bestân tafoegje tagelyk as jo jo nije repository oanmeitsje. GitHub biedt ek oare mienskiplike opsjes lykas in lisinsjebestân, mar jo hoege earst gjin ien te selektearjen.

Om in nije repository te meitsjen, selektearje rjochtsboppe yn it menu New repository. Gean troch mei de folgjende stappen:

1. Brûk yn 'e rjochter boppeste hoeke fan elke side it útklapmenu en selektearje New repository.

1. Fier yn it fak Repository Name yn first-repository.
2. Skriuw in koarte beskriuwing yn it fak Beskriuwing.
3. Selektearje Add a README triem.
4. Selektearje oft jo repository iepenbier of privee sil wêze.
5. Klikje op Create repository.

It meitsjen fan in branch

Troch in tûke oan te meitsjen kinne jo tagelyk ferskate ferzjes fan in repository hawwe.

Standertdefinita, de repository first-repository hat in neamde tûke main dat wurdt beskôge as de branch definitive. Jo kinne ekstra tûken oanmeitsje om yn 'e repository te haadjen first-repository. Jo kinne tûken brûke om ferskate ferzjes fan in projekt tagelyk te hawwen. Dit is handich as jo nije funksjonaliteit taheakje wolle oan in projekt sûnder de haadboarnekoade te feroarjen. Wurk dien oan ferskate tûken sil net ferskine op 'e mastertûke oant jo it fusearje. Jo kinne tûken brûke om te eksperimintearjen en wizigingen te meitsjen foardat jo se ynsette foar haad.

As jo ​​in tûke meitsje fan 'e haadtûke, meitsje jo in kopy, of momintopname, fan main lykas it op dat stuit wie. As immen oars wizigingen makke oan 'e mastertûke wylst jo oan jo branch wurken, kinne jo dizze updates drukke.

Yn it folgjende diagram kinne wy ​​​​sjen:

De haadtûke
In nije branch neamd feature
It paad dat de feature fiert foardat se gearfoege wurde mei haad

In tûke oanmeitsje foar in nije ymplemintaasje of bugfix is ​​as it bewarjen fan in bestân. Mei GitHub brûke software-ûntwikkelders tûken om bugfixes te hâlden, en funksjewurk, apart fan 'e haadproduksjetak. As in feroaring klear is, wurdt it gearfoege yn 'e haadtûke.

Litte wy in tûke meitsje

Gean nei it ljepblêd nei it meitsjen fan ús repository <>Code(1) fan de repository:

Klikje op it haadútklapmenu (2), en jou dan de nije in namme branch (3)

Klikje op Create branch: first branch from 'main'

No hawwe wy twa branch, main e first-branch. Op it stuit sjogge se krekt itselde. Letter sille wy de wizigingen tafoegje oan de nije branch.

Feroarings meitsje en befêstigje

Krekt makke de nije branch, GitHub brocht jo nei de code page foar de nije first-branch, dat is in kopy fan main.

Wy kinne wizigingen meitsje en opslaan yn bestannen yn it repository. Op GitHub wurde bewarre wizigingen neamd commit, Elk commit hat in berjocht fan commit assosjearre, dat is in beskriuwing dy't ferklearret wêrom't in bepaalde feroaring is makke. De berjochten fan commit se fange de skiednis fan feroaringen, sadat oare bydragen kinne begripe wat der dien is en wêrom.

Under de tak first-branch oanmakke, klikje op it bestân README.md, en dan op it potlead om it bestân te bewurkjen.

Skriuw yn 'e bewurker mei Markdown.

Yn it fak Commit changes (foarbyld), wy skriuwe in berjocht fan commit de feroarings beskriuwe.

As lêste klikje op de knop Commit changes.

Dizze wizigingen wurde allinich makke yn it README-bestân first-branch, dus no befettet dizze tûke oare ynhâld as de wichtichste.

Iepening fan ien pull request

No't wy wizigingen hawwe yn in tûke fan haad, kinne wy ​​ien iepenje pull request.

Le pull request se binne it hert fan 'e gearwurking op GitHub. As jo ​​iepenje in pull request, jo stelle jo wizigingen foar en freegje immen om in te meitsjen review e pull fan jo bydrage en om se te fusearjen yn har branch. De pull request lit de ferskillen fan de ynhâld fan beide tûken sjen. Feroarings, tafoegings en subtractions wurde werjûn yn ferskate kleuren.

Sadree't jo in commit meitsje, kinne jo in pull-fersyk iepenje en in diskusje begjinne, sels foardat de koade klear is.

Mei help fan de funksje @mention fan GitHub yn jo berjocht fan pull request, kinne jo spesifike minsken of teams freegje om feedback, nettsjinsteande har lokaasje.

Jo kinne sels iepenje pull request yn jo repository en fusearje se sels. It is in geweldige manier om de GitHub-stream te learen foardat jo wurkje oan gruttere projekten.

Om ien te meitsjen pull request do moast:

• Klikje op it ljepblêd pull request fan jo repository first-repository.

• Klikje op New pull request
• Yn de doaze Example Comparisons, selektearje de tûke dy't jo makke hawwe, first-branch, te fergelykjen mei haad (it orizjineel).
• Kontrolearje jo feroarings yn 'e ferskillen op' e Fergelykje side, soargje derfoar dat it dejinge binne dy't jo wolle yntsjinje.

• Klikje op Create pull request.

• Jou dy in titel pull request skriuw in koarte beskriuwing fan jo feroarings. Jo kinne emojis opnimme en ôfbyldings en gifs slepe en droppe.

• Opsjoneel, rjochts fan 'e titel en beskriuwing, klikje neist Reviewers. Untfangers, labels, projekten of mylpalen om ien fan dizze opsjes oan josels ta te foegjen pull request. Jo hoege se noch net ta te foegjen, mar dizze opsjes biede ferskate manieren om gear te wurkjen mei jo pull request.
• Klikje op Create pull request.

Jo meiwurkers kinne no jo wizigingen besjen en suggestjes dwaan.

Jou dy gearfoegje pull request

Yn dizze lêste stap sille jo jo branch gearfoegje first-branch yn de haadtak. Nei gearfoeging fan de pull request, feroarings oan de branch first-branch sil wurde ynbêde yn de triem haad.

Soms kin in pull fersyk ynfiere koade feroarings dy't konflikt mei besteande koade op main. As d'r konflikten binne, sil GitHub jo warskôgje foar de konfliktende koade en de fúzje foarkomme oant de konflikten binne oplost. Jo kinne in commit meitsje dy't de konflikten oplost of de opmerkingen yn 'e pull-fersyk brûke om de konflikten mei jo teamleden te besprekken.

• Klikje op Merge pull request om de wizigingen te fusearjen yn haad.

• Klikje op Confirm merge. Jo krije in berjocht dat it fersyk mei sukses gearfoege is en it fersyk is ôfsletten.
• Klikje op Delete branch. No dat dyn richiesta pull wurdt gearfoege en jo wizigingen binne op haad, kinne jo de tûke feilich wiskje first-branch. As jo ​​fierdere wizigingen oan jo projekt wolle meitsje, kinne jo altyd in nije tûke meitsje en dit proses werhelje.

Ercole Palmeri