Erthyglau

GitHub beth ydyw a sut i'w ddefnyddio

Mae GitHub yn ddarn o feddalwedd a ddefnyddir yn eang gan dimau datblygu meddalwedd, ar gyfer rheoli fersiwn datblygu.

Mae'n ddefnyddiol pan fydd mwy nag un person yn gweithio ar brosiect.

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.

Repository

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:

  1. Yng nghornel dde uchaf unrhyw dudalen, defnyddiwch y gwymplen a dewiswch New repository.
  1. Yn y blwch Enw Cadwrfa, nodwch first-repository.
  2. Yn y blwch Disgrifiad, ysgrifennwch ddisgrifiad byr.
  3. Dewiswch Ychwanegu ffeil README .
  4. Dewiswch a fydd eich ystorfa yn gyhoeddus neu'n breifat.
  5. Cliciwch ar Create repository.

Creu cangen

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.

Gadewch i ni greu cangen

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.

Gwneud a chadarnhau newidiadau

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.

Cylchlythyr arloesi
Peidiwch â cholli'r newyddion pwysicaf am arloesi. Cofrestrwch i'w derbyn trwy e-bost.

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.

Agoriad 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:

  • Cliciwch ar y tab pull request o'ch ystorfa first-repository.
  • Cliciwch ar New pull request
  • Yn y blwch Example Comparisons, dewiswch y gangen a grewyd gennych, first-branch, i'w gymharu â phrif (y gwreiddiol).
  • Adolygwch eich newidiadau yn y gwahaniaethau ar y dudalen Cymharu, gwnewch yn siŵr mai dyma'r rhai rydych chi am eu cyflwyno.
  • Cliciwch ar Create pull request.
  • Rhowch deitl i'ch un chi pull request ysgrifennu disgrifiad byr o'ch newidiadau. Gallwch gynnwys emojis a delweddau llusgo a gollwng a gifs.
  • Yn ddewisol, i'r dde o'r teitl a'r disgrifiad, cliciwch nesaf at Adolygwyr. Derbynwyr, Labeli, Prosiectau neu Gerrig Milltir i ychwanegu unrhyw un o'r opsiynau hyn at eich un chi 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.
  • Cliciwch ar Create pull request.

Gall eich cydweithwyr nawr adolygu eich newidiadau a gwneud awgrymiadau.

Cyfunwch eich un chi 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.

  • Cliciwch ar Merge pull request i uno'r newidiadau i'r prif gyflenwad.
  • Cliciwch ar Confirm merge. Byddwch yn derbyn neges bod y cais wedi'i gyfuno'n llwyddiannus a bod y cais wedi'i gau.
  • Cliciwch ar 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

Cylchlythyr arloesi
Peidiwch â cholli'r newyddion pwysicaf am arloesi. Cofrestrwch i'w derbyn trwy e-bost.

Erthyglau Diweddar

Marchnad Smart Lock: adroddiad ymchwil marchnad wedi'i gyhoeddi

Mae'r term Marchnad Lock Smart yn cyfeirio at y diwydiant a'r ecosystem sy'n ymwneud â chynhyrchu, dosbarthu a defnyddio…

Mawrth 27 2024

Beth yw patrymau dylunio: pam eu defnyddio, dosbarthiad, manteision ac anfanteision

Mewn peirianneg meddalwedd, patrymau dylunio yw'r atebion gorau posibl i broblemau sy'n digwydd yn aml mewn dylunio meddalwedd. Rydw i fel…

Mawrth 26 2024

Esblygiad technolegol marcio diwydiannol

Mae marcio diwydiannol yn derm eang sy'n cwmpasu sawl techneg a ddefnyddir i greu marciau parhaol ar wyneb…

Mawrth 25 2024

Enghreifftiau o Macros Excel wedi'u hysgrifennu gyda VBA

Ysgrifennwyd yr enghreifftiau macro Excel syml canlynol gan ddefnyddio amcangyfrif o amser darllen VBA: 3 funud Enghraifft…

Mawrth 25 2024