Er enghraifft, mae'n debyg bod tîm o ddatblygwyr meddalwedd eisiau adeiladu gwefan ac mae angen iddynt oll ddiweddaru'r cod, ar yr un pryd, wrth weithio ar y prosiect. Yn yr achos hwn, mae Github yn helpu i greu ystorfa ganolog lle gall pawb uwchlwytho, golygu a rheoli ffeiliau cod rhaglen.
Cyn i chi ddechrau defnyddio GitHub, mae angen i chi greu cyfrif GitHub.
Defnyddir ystorfa fel arfer i drefnu prosiect meddalwedd cymhwysiad. Gall storfeydd gynnwys ffolderi a ffeiliau, delweddau, fideos, taenlenni a setiau data - popeth sydd ei angen ar eich prosiect. Yn aml mae cadwrfeydd yn cynnwys ffeil README, ffeil gyda gwybodaeth am eich prosiect.
Ysgrifennir ffeiliau README yn iaith Markdown mewn testun plaen. Gallwch ymgynghori y dudalen hon we fel cyfeiriad cyflym o'r iaith Markdown. Mae GitHub yn caniatáu ichi ychwanegu ffeil README ar yr un pryd ag y byddwch chi'n creu eich ystorfa newydd. Mae GitHub hefyd yn cynnig opsiynau cyffredin eraill fel ffeil trwydded, ond nid oes angen i chi ddewis unrhyw rai i ddechrau.
I greu ystorfa newydd, ar y dde uchaf dewiswch yn y ddewislen New repository
. Ewch ymlaen â'r camau canlynol:
New repository
.first-repository
.Create repository
.Mae creu cangen yn caniatáu ichi gael sawl fersiwn o ystorfa ar yr un pryd.
Yn ddiofyndefinita, yr ystorfa first-repository
mae ganddo gangen a enwir main
a ystyrir yn gangen definitif. Gallwch greu canghennau ychwanegol i'w gosod yn yr ystorfa first-repository
. Gallwch ddefnyddio canghennau i gael fersiynau gwahanol o brosiect ar yr un pryd. Mae hyn yn ddefnyddiol pan fyddwch am ychwanegu swyddogaethau newydd i brosiect heb newid y prif god ffynhonnell. Ni fydd gwaith a wneir ar wahanol ganghennau yn ymddangos ar y brif gangen nes i chi ei huno. Gallwch ddefnyddio canghennau i arbrofi a gwneud newidiadau cyn ymrwymo i'r prif gyflenwad.
Pan fyddwch chi'n creu cangen o'r brif gangen, rydych chi'n gwneud copi, neu gipolwg, o'r brif gangen fel yr oedd ar y pryd. Pe bai rhywun arall yn gwneud newidiadau i'r brif gangen tra oeddech chi'n gweithio ar eich cangen, fe allech chi wthio'r diweddariadau hynny.
Yn y diagram canlynol gallwn weld:
Y brif gangen
Galwodd cangen newydd feature
Y llwybr y mae'r feature
perfformio cyn cael ei uno â phrif
Mae creu cangen ar gyfer gweithrediad newydd neu atgyweiriad nam fel arbed ffeil. Gyda GitHub, mae datblygwyr meddalwedd yn defnyddio canghennau i gadw atgyweiriadau nam, a gwaith nodwedd, ar wahân i'r brif gangen gynhyrchu. Pan fydd newid yn barod, caiff ei uno â'r brif gangen.
Ar ôl creu ein cadwrfa, symudwch i'r tab <>Code
(1) o'r gadwrfa:
Cliciwch y brif ddewislen (2) i lawr, ac yna rhowch enw i'r un newydd branch
(3)
Cliciwch ar Create branch: first branch from 'main'
Nawr mae gennym ni ddau branch
, main
e first-branch
. Ar hyn o bryd, maen nhw'n edrych yn union yr un fath. Yn ddiweddarach byddwn yn ychwanegu'r newidiadau i'r un newydd branch
.
Newydd greu'r un newydd branch
, Daeth GitHub â chi i'r code page
ar gyfer y newydd first-branch
, sef copi o brif.
Gallwn wneud ac arbed newidiadau i ffeiliau yn y gadwrfa. Ar GitHub, gelwir newidiadau sydd wedi'u cadw commit
. Pob commit
Mae ganddo neges gan commit
cysylltiedig, sef disgrifiad sy'n esbonio pam y gwnaed newid penodol. Mae negeseuon o commit
maent yn dal hanes newidiadau fel bod cyfranwyr eraill yn gallu deall beth a wnaed a pham.
O dan y gangen first-branch
creu, cliciwch ar y ffeil README.md, ac yna ar y pensil i olygu'r ffeil.
Yn y golygydd, ysgrifennwch gan ddefnyddio Markdown.
Yn y blwch Commit changes
(Rhagolwg), rydym yn ysgrifennu neges o commit
yn disgrifio’r newidiadau.
Yn olaf cliciwch ar y botwm Commit changes
.
Bydd y newidiadau hyn yn cael eu gwneud i'r ffeil README yn unig first-branch
, felly nawr mae'r gangen hon yn cynnwys gwahanol gynnwys na'r prif un.
pull request
Nawr bod gennym ni newidiadau mewn cangen oddi ar y prif gyflenwad, gallwn agor un pull request
.
Le pull request
nhw yw calon y cydweithio ar GitHub. Pan fyddwch yn agor a pull request
, rydych yn cynnig eich newidiadau ac yn gofyn i rywun wneud a review
e pull
o'ch cyfraniad a'u huno yn eu cangen. Mae'r pull request
dangos gwahaniaethau cynnwys y ddwy gangen. Dangosir newidiadau, adio a thynnu mewn gwahanol liwiau.
Cyn gynted ag y byddwch yn ymrwymo, gallwch agor cais tynnu a dechrau trafodaeth, hyd yn oed cyn i'r cod ddod i ben.
Gan ddefnyddio'r swyddogaeth @mention
gan GitHub yn eich post o pull request
, gallwch ofyn i bobl neu dimau penodol am adborth, waeth beth fo'u lleoliad.
Gallwch hyd yn oed agor pull request
yn eich ystorfa a chyfunwch hwy eich hunain. Mae'n ffordd wych o ddysgu ffrwd GitHub cyn gweithio ar brosiectau mwy.
I wneud un pull request
rhaid i chi:
pull request
o'ch ystorfa first-repository
. New pull request
Example Comparisons
, dewiswch y gangen a grewyd gennych, first-branch
, i'w gymharu â phrif (y gwreiddiol).Create pull request
.pull request
ysgrifennu disgrifiad byr o'ch newidiadau. Gallwch gynnwys emojis a delweddau llusgo a gollwng a gifs.pull request
. Nid oes angen i chi eu hychwanegu eto, ond mae'r opsiynau hyn yn cynnig sawl ffordd o gydweithio gan ddefnyddio'ch pull request
. Create pull request
.Gall eich cydweithwyr nawr adolygu eich newidiadau a gwneud awgrymiadau.
pull request
Yn y cam olaf hwn, byddwch yn uno'ch cangen first-branch
yn y brif gangen. Ar ôl uno'r pull request
, newidiadau i'r gangen first-branch
yn cael ei fewnosod ym mhrif ffeil.
Weithiau, gall cais tynnu gyflwyno newidiadau cod sy'n gwrthdaro â'r cod presennol ar y prif gyflenwad. Os oes unrhyw wrthdaro, bydd GitHub yn eich rhybuddio am y cod sy'n gwrthdaro ac yn atal yr uno nes bod y gwrthdaro wedi'i ddatrys. Gallwch wneud ymrwymiad sy'n datrys y gwrthdaro neu ddefnyddio'r sylwadau yn y cais tynnu i drafod y gwrthdaro ag aelodau'ch tîm.
Merge pull request
i uno'r newidiadau i'r prif gyflenwad.Confirm merge
. Byddwch yn derbyn neges bod y cais wedi'i gyfuno'n llwyddiannus a bod y cais wedi'i gau.Delete branch
. Nawr bod eich richiesta pull
wedi'i uno a bod eich newidiadau ar y prif, gallwch ddileu'r gangen yn ddiogel first-branch
. Os ydych chi eisiau gwneud newidiadau pellach i'ch prosiect, gallwch chi bob amser greu cangen newydd ac ailadrodd y broses hon.Ercole Palmeri
Mae'r term Marchnad Lock Smart yn cyfeirio at y diwydiant a'r ecosystem sy'n ymwneud â chynhyrchu, dosbarthu a defnyddio…
Mewn peirianneg meddalwedd, patrymau dylunio yw'r atebion gorau posibl i broblemau sy'n digwydd yn aml mewn dylunio meddalwedd. Rydw i fel…
Mae marcio diwydiannol yn derm eang sy'n cwmpasu sawl techneg a ddefnyddir i greu marciau parhaol ar wyneb…
Ysgrifennwyd yr enghreifftiau macro Excel syml canlynol gan ddefnyddio amcangyfrif o amser darllen VBA: 3 funud Enghraifft…