GitHub hvað það er og hvernig á að nota það

GitHub er hugbúnaður sem er mikið notaður af hugbúnaðarþróunarteymi, fyrir þróunarútgáfustýringu.

Það er gagnlegt þegar fleiri en einn vinna að verkefni.

Segjum sem svo að teymi hugbúnaðarhönnuða vilji byggja vefsíðu og þeir þurfi allir að uppfæra kóðann samtímis á meðan þeir vinna að verkefninu. Í þessu tilviki hjálpar Github að búa til miðlæga geymslu þar sem allir geta hlaðið upp, breytt og stjórnað forritskóðaskrám.

Áður en þú byrjar að nota GitHub þarftu að búa til reikning GitHub.

Geymsla

Geymsla er venjulega notuð til að skipuleggja forritahugbúnaðarverkefni. Geymslur geta innihaldið möppur og skrár, myndir, myndbönd, töflureikna og gagnasöfn - allt sem verkefnið þitt þarfnast. Oft innihalda geymslur README skrá, skrá með upplýsingum um verkefnið þitt.

README skrár eru skrifaðar á Markdown tungumáli í venjulegum texta. Þú getur ráðfært þig Þessi síða vefur sem fljótleg tilvísun í Markdown tungumálið. GitHub gerir þér kleift að bæta við README skrá á sama tíma og þú býrð til nýju geymsluna þína. GitHub býður einnig upp á aðra algenga valkosti eins og leyfisskrá, en þú þarft ekki að velja neina í upphafi.

Til að búa til nýja geymslu skaltu velja efst til hægri í valmyndinni New repository. Haltu áfram með eftirfarandi skrefum:

1. Í efra hægra horninu á hvaða síðu sem er, notaðu fellivalmyndina og veldu New repository.

1. Í reitnum Geymsluheiti, sláðu inn first-repository.
2. Skrifaðu stutta lýsingu í reitinn Lýsing.
3. Veldu Bæta við README skrá.
4. Veldu hvort geymslan þín verður opinber eða einkarekin.
5. Smelltu Create repository.

Að búa til útibú

Að búa til útibú gerir þér kleift að hafa nokkrar útgáfur af geymslu á sama tíma.

Sjálfgefiðdefinita, geymslan first-repository hefur nafngreint útibú main sem telst útibúið definitive. Þú getur búið til viðbótar útibú til að vera í geymslunni first-repository. Þú getur notað útibú til að hafa mismunandi útgáfur af verkefni á sama tíma. Þetta er gagnlegt þegar þú vilt bæta nýjum virkni við verkefni án þess að breyta aðal frumkóðanum. Vinna sem unnin er á mismunandi útibúum mun ekki birtast á aðalútibúinu fyrr en þú sameinar hana. Þú getur notað útibú til að gera tilraunir og gera breytingar áður en þú skuldbindur þær til aðal.

Þegar þú býrð til útibú úr aðalútibúinu ertu að gera afrit, eða skyndimynd, af main eins og það var á því augnabliki. Ef einhver annar gerði breytingar á aðalútibúinu á meðan þú varst að vinna í útibúinu þínu gætirðu ýtt á þær uppfærslur.

Í eftirfarandi skýringarmynd getum við séð:

Aðalútibúið
Nýtt útibú heitir feature
Leiðin sem feature framkvæmir áður en það er sameinað aðal

Að búa til útibú fyrir nýja útfærslu eða villuleiðréttingu er eins og að vista skrá. Með GitHub nota hugbúnaðarframleiðendur útibú til að halda villuleiðréttingum og lögun vinnu, aðskilin frá aðalframleiðslugreininni. Þegar breyting er tilbúin er hún sameinuð í aðalútibúið.

Við skulum búa til útibú

Eftir að hafa búið til geymsluna okkar, farðu á flipann <>Code(1) geymslunnar:

Smelltu á aðal fellivalmyndina (2) og gefðu þeim nýja nafn branch (3)

Smelltu á Create branch: first branch from 'main'

Nú erum við með tvær branch, main e first-branch. Núna líta þeir nákvæmlega eins út. Síðar munum við bæta breytingunum við þann nýja branch.

Gerðu og staðfestu breytingar

Búið bara til nýja branch, GitHub leiddi þig til code page fyrir hið nýja first-branch, sem er afrit af main.

Við getum gert og vistað breytingar á skrám í geymslunni. Á GitHub eru vistaðar breytingar kallaðar commit. Sérhver commit er með skilaboð frá commit tengd, sem er lýsing sem útskýrir hvers vegna tiltekin breyting var gerð. Skilaboðin frá commit þeir fanga sögu breytinga þannig að aðrir þátttakendur geti skilið hvað var gert og hvers vegna.

Undir greininni first-branch búið til, smelltu á README.md skrána og síðan á blýantinn til að breyta skránni.

Í ritlinum skaltu skrifa með Markdown.

Í kassanum Commit changes (Preview), við skrifum skilaboð um commit lýsir breytingunum.

Smelltu að lokum á hnappinn Commit changes.

Þessar breytingar verða eingöngu gerðar á README skránni first-branch, þannig að nú inniheldur þessi grein annað efni en það helsta.

Opnun á einum pull request

Nú þegar við höfum breytingar á aðalútibúi getum við opnað einn pull request.

Le pull request þeir eru hjarta samstarfsins á GitHub. Þegar þú opnar a pull request, þú ert að leggja til breytingar þínar og biðja einhvern um að gera a review e pull af framlagi þínu og að sameina þau í þeirra útibú. The pull request sýna mun á innihaldi beggja greinanna. Breytingar, samlagning og frádráttur eru sýndar í mismunandi litum.

Um leið og þú skuldbindur þig geturðu opnað pull beiðni og byrjað umræðu, jafnvel áður en kóðinn er búinn.

Að nota aðgerðina @mention af GitHub í skilaboðum þínum um pull request, þú getur beðið tiltekið fólk eða teymi um endurgjöf, óháð staðsetningu þeirra.

Þú getur jafnvel opnað pull request í geymslunni þinni og sameinaðu þau sjálfur. Það er frábær leið til að læra á GitHub strauminn áður en unnið er að stærri verkefnum.

Að búa til einn pull request þú verður að:

• Smelltu á flipann pull request af geymslunni þinni first-repository.

• Smelltu New pull request
• Í kassanum Example Comparisons, veldu útibúið sem þú bjóst til, first-branch, að bera saman við aðal (frumritið).
• Skoðaðu breytingar þínar á mismuninum á Bera saman síðunni, vertu viss um að það séu þær sem þú vilt senda inn.

• Smelltu Create pull request.

• Gefðu þér titil pull request skrifaðu stutta lýsingu á breytingunum þínum. Þú getur látið emojis fylgja með og draga og sleppa myndum og gifs.

• Valfrjálst, hægra megin við titilinn og lýsinguna, smelltu á hliðina á Gagnrýnendur. Viðtakendur, merkimiðar, verkefni eða áfangar til að bæta einhverjum af þessum valkostum við þinn pull request. Þú þarft ekki að bæta þeim við ennþá, en þessir valkostir bjóða upp á nokkrar leiðir til að vinna með því að nota pull request.
• Smelltu Create pull request.

Samstarfsaðilar þínir geta nú skoðað breytingarnar þínar og komið með tillögur.

Sameinaðu þitt pull request

Í þessu síðasta skrefi sameinar þú útibúið þitt first-branch í aðalútibúi. Eftir sameiningu á pull request, breytingar á útibúinu first-branch verður fellt inn í aðalskrána.

Stundum getur dráttarbeiðni kynnt kóðabreytingar sem stangast á við núverandi kóða á main. Ef það eru einhver átök mun GitHub vara þig við kóðanum sem stangast á og koma í veg fyrir sameiningu þar til átökin eru leyst. Þú getur gert skuldbindingu sem leysir átökin eða notað athugasemdirnar í pull beiðninni til að ræða átökin við liðsmenn þína.

• Smelltu Merge pull request að sameina breytingarnar í aðal.

• Smelltu Confirm merge. Þú færð skilaboð um að beiðnin hafi tekist að sameinast og beiðninni hafi verið lokað.
• Smelltu Delete branch. Nú þegar þinn richiesta pull er sameinuð og breytingarnar þínar eru á aðal, geturðu örugglega eytt útibúinu first-branch. Ef þú vilt gera frekari breytingar á verkefninu þínu geturðu alltaf búið til nýja útibú og endurtekið þetta ferli.

Ercole Palmeri