GitHub x'inhu u kif tużah

GitHub hija biċċa softwer użata ħafna mit-timijiet tal-iżvilupp tas-softwer, għall-kontroll tal-verżjoni tal-iżvilupp.

Huwa utli meta aktar minn persuna waħda tkun qed taħdem fuq proġett.

Per eżempju, ngħidu aħna tim ta 'żviluppaturi ta' softwer iridu jibnu websajt u kollha jeħtieġu jaġġornaw il-kodiċi, fl-istess ħin, waqt li jaħdmu fuq il-proġett. F'dan il-każ, Github jgħin biex jinħoloq repożitorju ċentralizzat fejn kulħadd jista 'jtella', jeditja u jimmaniġġja fajls tal-kodiċi tal-programm.

Qabel ma tibda tuża GitHub, trid toħloq kont GitHub.

Repożitorju

Repożitorju huwa normalment użat biex jorganizza proġett ta 'softwer ta' applikazzjoni. Repożitorji jista' jkun fihom folders u fajls, stampi, vidjows, spreadsheets u datasets - dak kollu li jeħtieġ il-proġett tiegħek. Ħafna drabi r-repożitorji jinkludu fajl README, fajl b'informazzjoni dwar il-proġett tiegħek.

Il-fajls README jinkitbu bil-lingwa Markdown f'test sempliċi. Tista' tikkonsulta Din il-Paġna web bħala referenza rapida tal-lingwa Markdown. GitHub jippermettilek li żżid fajl README fl-istess ħin li toħloq ir-repożitorju l-ġdid tiegħek. GitHub joffri wkoll għażliet komuni oħra bħal fajl tal-liċenzja, iżda m'għandekx bżonn tagħżel inizjalment.

Biex toħloq repożitorju ġdid, fin-naħa ta' fuq tal-lemin agħżel fil-menu New repository. Ipproċedi bil-passi li ġejjin:

1. Fir-rokna ta 'fuq tal-lemin ta' kwalunkwe paġna, uża l-menu drop-down u agħżel New repository.

1. Fil-kaxxa Isem tar-Repożitorju, daħħal first-repository.
2. Fil-kaxxa Deskrizzjoni, ikteb deskrizzjoni qasira.
3. Agħżel Żid fajl README.
4. Agħżel jekk ir-repożitorju tiegħek hux pubbliku jew privat.
5. Ikklikkja fuq Create repository.

Ħolqien ta 'fergħa

Il-ħolqien ta 'fergħa jippermettilek li jkollok diversi verżjonijiet ta' repożitorju fl-istess ħin.

B'mod awtomatikudefinita, ir-repożitorju first-repository għandha fergħa msemmija main li hija meqjusa bħala l-fergħa definittiv. Tista 'toħloq fergħat addizzjonali għall-main fir-repożitorju first-repository. Tista 'tuża fergħat biex ikollok verżjonijiet differenti ta' proġett fl-istess ħin. Dan huwa utli meta trid iżżid funzjonalità ġdida għal proġett mingħajr ma tbiddel il-kodiċi tas-sors ewlieni. Ix-xogħol magħmul fuq fergħat differenti mhux se jidher fuq il-fergħa prinċipali sakemm tgħaqqadha. Tista 'tuża fergħat biex tesperimenta u tagħmel bidliet qabel ma tikkommettihom għall-main.

Meta toħloq fergħa mill-fergħa prinċipali, tkun qed tagħmel kopja, jew snapshot, ta 'main kif kienet f'dak il-mument. Jekk xi ħadd ieħor għamel bidliet fil-fergħa prinċipali waqt li kont qed taħdem fuq il-fergħa tiegħek, tista' timbotta dawk l-aġġornamenti.

Fid-dijagramma li ġejja nistgħu naraw:

Il-fergħa prinċipali
Fergħa ġdida imsejħa feature
It-triq li l- feature twettaq qabel ma tiġi magħquda ma main

Il-ħolqien ta 'fergħa għal implimentazzjoni ġdida jew soluzzjoni ta' bug huwa bħall-iffrankar ta 'fajl. Bil-GitHub, l-iżviluppaturi tas-softwer jużaw fergħat biex iżommu l-bug fixes, u x-xogħol tal-karatteristiċi, separati mill-fergħa prinċipali tal-produzzjoni. Meta bidla tkun lesta, hija magħquda fil-fergħa prinċipali.

Ejja noħolqu fergħa

Wara li ħoloq ir-repożitorju tagħna, imxi fit-tab <>Code(1) tar-repożitorju:

Ikklikkja l-menu drop-down prinċipali (2), u mbagħad agħti isem lil dak il-ġdid branch (3)

Ikklikkja fuq Create branch: first branch from 'main'

Issa għandna tnejn branch, main e first-branch. Dritt issa, huma jidhru eżattament l-istess. Iktar tard inżidu l-bidliet mal-ġdid branch.

Agħmel u kkonferma l-bidliet

Ħoloq biss il-ġdid branch, GitHub ġabek fil- code page għall-ġdid first-branch, li hija kopja ta' main.

Nistgħu nagħmlu u niffrankaw bidliet fil-fajls fir-repożitorju. Fuq GitHub, jissejħu bidliet salvati commit. Kull commit għandu messaġġ minn commit assoċjati, li hija deskrizzjoni li tispjega għaliex saret bidla partikolari. Il-messaġġi ta' commit huma jaqbdu l-istorja tal-bidliet sabiex kontributuri oħra jkunu jistgħu jifhmu dak li sar u għaliex.

Taħt il-fergħa first-branch maħluqa, ikklikkja fuq il-fajl README.md, u mbagħad fuq il-lapes biex teditja l-fajl.

Fl-editur, ikteb billi tuża Markdown.

Fil-kaxxa Commit changes (Preview), niktbu messaġġ ta ' commit jiddeskrivi l-bidliet.

Fl-aħħarnett ikklikkja fuq il-buttuna Commit changes.

Dawn il-bidliet se jsiru fil-fajl README biss first-branch, għalhekk issa din il-fergħa fiha kontenut differenti minn dak prinċipali.

Ftuħ ta' wieħed pull request

Issa li għandna bidliet f'fergħa off main, nistgħu niftħu waħda pull request.

Le pull request huma l-qalba tal-kollaborazzjoni fuq GitHub. Meta tiftaħ a pull request, qed tipproponi l-bidliet tiegħek u titlob lil xi ħadd biex jagħmel a review e pull tal-kontribuzzjoni tiegħek u biex tgħaqqadhom fil-fergħa tagħhom. Il- pull request juru d-differenzi tal-kontenut taż-żewġ fergħat. Bidliet, żidiet u tnaqqis huma murija b'kuluri differenti.

Hekk kif tagħmel impenn, tista 'tiftaħ talba ta' ġibda u tibda diskussjoni, anki qabel ma jintemm il-kodiċi.

Bl-użu tal-funzjoni @mention ta' GitHub fil-messaġġ tiegħek ta' pull request, tista' titlob lil nies jew timijiet speċifiċi għal feedback, irrispettivament mill-lokalità tagħhom.

Tista 'anki tiftaħ pull request fir-repożitorju tiegħek u għaqqadhom lilek innifsek. Huwa mod tajjeb ħafna biex titgħallem il-fluss GitHub qabel ma taħdem fuq proġetti akbar.

Biex tagħmel a pull request trid:

• Ikklikkja fuq it-tab pull request tar-repożitorju tiegħek first-repository.

• Ikklikkja fuq New pull request
• Fil-kaxxa Example Comparisons, agħżel il-fergħa li ħloqt, first-branch, li għandu jitqabbel mal-main (l-oriġinal).
• Irrevedi l-bidliet tiegħek fid-differenzi fil-paġna Qabbel, kun żgur li huma dawk li trid tissottometti.

• Ikklikkja fuq Create pull request.

• Agħti titolu tiegħek pull request ikteb deskrizzjoni qasira tal-bidliet tiegħek. Tista' tinkludi emojis u drag and drop immaġini u gifs.

• B'għażla, fuq il-lemin tat-titlu u d-deskrizzjoni, ikklikkja ħdejn Reviżuri. Riċevituri, Tikketti, Proġetti jew Tragwardi biex iżżid xi waħda minn dawn l-għażliet ma' tiegħek pull request. S'issa m'għandekx bżonn iżżidhom, iżda dawn l-għażliet joffru diversi modi kif tikkollabora bl-użu tiegħek pull request.
• Ikklikkja fuq Create pull request.

Il-kollaboraturi tiegħek issa jistgħu jirrevedu l-bidliet tiegħek u jagħmlu suġġerimenti.

Għaqqad tiegħek pull request

F'dan il-pass finali, int ser tgħaqqad il-fergħa tiegħek first-branch fil-fergħa prinċipali. Wara li tgħaqqad il- pull request, bidliet fil-fergħa first-branch se jkun inkorporat fil-file main.

Xi drabi, talba ta 'ġibda tista' tintroduċi bidliet fil-kodiċi li jikkonfliġġu mal-kodiċi eżistenti fuq main. Jekk ikun hemm xi kunflitti, GitHub twissik dwar il-kodiċi konfliġġenti u jipprevjeni l-għaqda sakemm il-kunflitti jiġu solvuti. Tista' tagħmel impenn li jsolvi l-kunflitti jew tuża l-kummenti fit-talba tal-ġibda biex tiddiskuti l-kunflitti mal-membri tat-tim tiegħek.

• Ikklikkja fuq Merge pull request biex jingħaqdu l-bidliet fil-main.

• Ikklikkja fuq Confirm merge. Inti ser tirċievi messaġġ li t-talba ġiet magħquda b'suċċess u t-talba ngħalqet.
• Ikklikkja fuq Delete branch. Issa li tiegħek richiesta pull hija magħquda u l-bidliet tiegħek huma fuq main, tista 'tħassar il-fergħa mingħajr periklu first-branch. Jekk trid tagħmel aktar bidliet fil-proġett tiegħek, tista' dejjem toħloq fergħa ġdida u tirrepeti dan il-proċess.

Ercole Palmeri