GitHub çfarë është dhe si ta përdorim atë

GitHub është një pjesë softuerike e përdorur gjerësisht nga ekipet e zhvillimit të softuerit, për kontrollin e versionit të zhvillimit.

Është e dobishme kur më shumë se një person është duke punuar në një projekt.

Për shembull, supozoni se një ekip zhvilluesish softuerësh duan të ndërtojnë një faqe interneti dhe të gjithë duhet të përditësojnë kodin, në të njëjtën kohë, ndërsa punojnë në projekt. Në këtë rast, Github ndihmon në krijimin e një depoje të centralizuar ku të gjithë mund të ngarkojnë, modifikojnë dhe menaxhojnë skedarët e kodit të programit.

Para se të filloni të përdorni GitHub, duhet të krijoni një llogari GitHub.

depo

Një depo zakonisht përdoret për të organizuar një projekt softuer aplikimi. Depot mund të përmbajnë dosje dhe skedarë, imazhe, video, fletëllogaritëse dhe grupe të dhënash - gjithçka që i nevojitet projektit tuaj. Shpesh depot përfshijnë një skedar README, një skedar me informacione rreth projektit tuaj.

Skedarët README shkruhen në gjuhën Markdown në tekst të thjeshtë. Mund të konsultoheni Kjo faqe ueb si një referencë e shpejtë e gjuhës Markdown. GitHub ju lejon të shtoni një skedar README në të njëjtën kohë kur krijoni depon tuaj të re. GitHub ofron gjithashtu opsione të tjera të zakonshme si një skedar licence, por nuk keni nevojë të zgjidhni ndonjë fillimisht.

Për të krijuar një depo të re, në të djathtën e sipërme zgjidhni në meny New repository. Vazhdoni me hapat e mëposhtëm:

1. Në këndin e sipërm të djathtë të çdo faqeje, përdorni menunë rënëse dhe zgjidhni New repository.

1. Në kutinë Emri i depove, futni first-repository.
2. Në kutinë e Përshkrimi, shkruani një përshkrim të shkurtër.
3. Zgjidhni Shto një skedar README.
4. Zgjidhni nëse depoja juaj do të jetë publike apo private.
5. Kliko Create repository.

Krijimi i një dege

Krijimi i një dege ju lejon të keni disa versione të një depoje në të njëjtën kohë.

Si parazgjedhjedefinita, depoja first-repository ka një degë të emërtuar main e cila konsiderohet dega definiitive. Ju mund të krijoni degë shtesë për t'u mbajtur në depo first-repository. Ju mund të përdorni degët për të pasur versione të ndryshme të një projekti në të njëjtën kohë. Kjo është e dobishme kur dëshironi të shtoni funksionalitet të ri në një projekt pa ndryshuar kodin burimor kryesor. Puna e bërë në degë të ndryshme nuk do të shfaqet në degën kryesore derisa ta bashkoni atë. Ju mund të përdorni degë për të eksperimentuar dhe për të bërë ndryshime përpara se t'i kryeni ato në main.

Kur krijoni një degë nga dega kryesore, po bëni një kopje, ose fotografi, të kryesores siç ishte në atë moment. Nëse dikush tjetër ka bërë ndryshime në degën kryesore ndërsa ju po punonit në degën tuaj, mund t'i shtyni ato përditësime.

Në diagramin e mëposhtëm mund të shohim:

Dega kryesore
Një degë e re quhet feature
Rruga që feature kryen përpara se të shkrihet me kryesore

Krijimi i një dege për një zbatim të ri ose rregullim të gabimeve është si të ruash një skedar. Me GitHub, zhvilluesit e softuerëve përdorin degë për të mbajtur korrigjimet e gabimeve dhe punën e veçorive, të ndara nga dega kryesore e prodhimit. Kur një ndryshim është gati, ai bashkohet në degën kryesore.

Le të krijojmë një degë

Pasi të keni krijuar depon tonë, kaloni te skeda <>Code(1) e depove:

Klikoni në menunë kryesore (2) rënëse dhe më pas jepni një emër të resë branch (3)

Klikoni mbi Create branch: first branch from 'main'

Tani kemi dy branch, main e first-branch. Tani për tani, ato duken saktësisht të njëjta. Më vonë do të shtojmë ndryshimet në të renë branch.

Bëni dhe konfirmoni ndryshimet

Sapo krijoi të renë branch, GitHub ju solli në code page për të renë first-branch, e cila është një kopje e kryesore.

Ne mund të bëjmë dhe ruajmë ndryshime në skedarë në depo. Në GitHub thirren ndryshimet e ruajtura commit. Çdo commit ka një mesazh nga commit lidhur, që është një përshkrim që shpjegon pse është bërë një ndryshim i veçantë. Mesazhet e commit ato kapin historinë e ndryshimeve në mënyrë që kontribuuesit e tjerë të mund të kuptojnë se çfarë është bërë dhe pse.

Nën degën first-branch krijuar, klikoni në skedarin README.md dhe më pas në laps për të redaktuar skedarin.

Në redaktues, shkruani duke përdorur Markdown.

Në kuti Commit changes (Parashikim), ne shkruajmë një mesazh të commit duke përshkruar ndryshimet.

Në fund klikoni në butonin Commit changes.

Këto ndryshime do të bëhen vetëm në skedarin README first-branch, kështu që tani kjo degë përmban përmbajtje të ndryshme nga ajo kryesore.

Hapja e njërës pull request

Tani që kemi ndryshime në një degë off kryesore, ne mund të hapim një pull request.

Le pull request ata janë zemra e bashkëpunimit në GitHub. Kur hapni një pull request, ju po propozoni ndryshimet tuaja dhe po i kërkoni dikujt të bëjë një review e pull të kontributit tuaj dhe t'i bashkojë në degën e tyre. Të pull request tregojnë dallimet e përmbajtjes së të dy degëve. Ndryshimet, shtimet dhe zbritjet tregohen me ngjyra të ndryshme.

Sapo të bëni një zotim, mund të hapni një kërkesë tërheqjeje dhe të filloni një diskutim, edhe para se kodi të përfundojë.

Duke përdorur funksionin @mention nga GitHub në postimin tuaj nga pull request, mund t'u kërkoni njerëzve ose ekipeve specifike për komente, pavarësisht vendndodhjes së tyre.

Ju madje mund të hapni pull request në depon tuaj dhe bashkojini ato vetë. Është një mënyrë e shkëlqyer për të mësuar rrjedhën e GitHub përpara se të punoni në projekte më të mëdha.

Për të bërë një pull request ju duhet të:

• Klikoni në skedën pull request të depove tuaja first-repository.

• Kliko New pull request
• Në kutinë Example Comparisons, zgjidhni degën që keni krijuar, first-branch, për t'u krahasuar me kryesore (origjinalin).
• Rishikoni ndryshimet tuaja në ndryshimet në faqen Krahasoni, sigurohuni që janë ato që dëshironi të paraqisni.

• Kliko Create pull request.

• Jepni titullin tuaj pull request shkruani një përshkrim të shkurtër të ndryshimeve tuaja. Mund të përfshini emoji dhe tërhiqni dhe lëshoni imazhe dhe gif.

• Opsionale, në të djathtë të titullit dhe përshkrimit, kliko pranë Rishikuesve. Marrësit, Etiketat, Projektet ose Piketat për të shtuar ndonjë nga këto opsione tek tuajat pull request. Nuk keni nevojë t'i shtoni ende, por këto opsione ofrojnë disa mënyra për të bashkëpunuar duke përdorur tuajin pull request.
• Kliko Create pull request.

Bashkëpunëtorët tuaj tani mund të shqyrtojnë ndryshimet tuaja dhe të bëjnë sugjerime.

Bashkoni tuajat pull request

Në këtë hap të fundit, ju do të bashkoni degën tuaj first-branch në degën kryesore. Pas bashkimit të pull request, ndryshime në degë first-branch do të futet në skedarin kryesor.

Ndonjëherë, një kërkesë tërheqëse mund të prezantojë ndryshime kodi që bien ndesh me kodin ekzistues në main. Nëse ka ndonjë konflikt, GitHub do t'ju paralajmërojë për kodin konfliktual dhe do të parandalojë bashkimin derisa të zgjidhen konfliktet. Ju mund të bëni një angazhim që zgjidh konfliktet ose të përdorni komentet në kërkesën për tërheqje për të diskutuar konfliktet me anëtarët e ekipit tuaj.

• Kliko Merge pull request për të bashkuar ndryshimet në kryesore.

• Kliko Confirm merge. Do të merrni një mesazh se kërkesa është bashkuar me sukses dhe kërkesa është mbyllur.
• Kliko Delete branch. Tani që e juaja richiesta pull është bashkuar dhe ndryshimet tuaja janë në krye, ju mund ta fshini me siguri degën first-branch. Nëse dëshironi të bëni ndryshime të mëtejshme në projektin tuaj, gjithmonë mund të krijoni një degë të re dhe ta përsërisni këtë proces.

Ercole Palmeri