GitHub kio ĝi estas kaj kiel uzi ĝin

GitHub estas programaro vaste uzata de programaraj teamoj por evoluiga versio-kontrolo.

Ĝi estas utila kiam pli ol unu persono laboras pri projekto.

Ekzemple, supozu, ke teamo de programistoj volas konstrui retejon kaj ili ĉiuj bezonas ĝisdatigi la kodon, samtempe, dum ili laboras pri la projekto. En ĉi tiu kazo, Github helpas krei centralizitan deponejon, kie ĉiuj povas alŝuti, redakti kaj administri programajn koddosierojn.

Antaŭ ol vi komencas uzi GitHub, vi devas krei konton GitHub.

Repository

Deponejo estas kutime uzata por organizi aplikaĵprogramaran projekton. Deponejoj povas enhavi dosierujojn kaj dosierojn, bildojn, filmetojn, kalkultabelojn kaj datumarojn - ĉion, kion via projekto bezonas. Ofte deponejoj inkluzivas README-dosieron, dosieron kun informoj pri via projekto.

README-dosieroj estas skribitaj en Markdown-lingvo en simpla teksto. Vi povas konsulti Ĉi tiu Paĝo retejo kiel rapida referenco de la Markdown-lingvo. GitHub permesas vin aldoni README-dosieron samtempe kiam vi kreas vian novan deponejon. GitHub ankaŭ ofertas aliajn oftajn eblojn kiel ekzemple licencdosiero, sed vi ne bezonas elekti iun komence.

Por krei novan deponejon, supre dekstre elektu en la menuo New repository. Sekvu la sekvajn paŝojn:

1. En la supra dekstra angulo de iu ajn paĝo, uzu la falmenuon kaj elektu New repository.

1. En la skatolo Deponejo Nomo, enigu first-repository.
2. En la skatolo Priskribo, skribu mallongan priskribon.
3. Elektu Aldoni README-dosieron.
4. Elektu ĉu via deponejo estos publika aŭ privata.
5. Alklaku Create repository.

Kreante branĉon

Krei branĉon permesas havi plurajn versiojn de deponejo samtempe.

Defaŭltedefinita, la deponejo first-repository havas nomitan branĉon main kiu estas konsiderata la branĉo definitivo. Vi povas krei pliajn branĉojn al ĉefo en la deponejo first-repository. Vi povas uzi branĉojn por havi malsamajn versiojn de projekto samtempe. Ĉi tio utilas kiam vi volas aldoni novajn funkciojn al projekto sen ŝanĝi la ĉefan fontkodon. Laboro farita sur malsamaj branĉoj ne aperos sur la majstra branĉo ĝis vi kunfandas ĝin. Vi povas uzi branĉojn por eksperimenti kaj fari ŝanĝojn antaŭ ol fari ilin al ĉefo.

Kiam vi kreas branĉon de la ĉefa branĉo, vi faras kopion, aŭ momentfoton, de ĉefa kiel ĝi estis en tiu momento. Se iu alia faris ŝanĝojn al la majstra branĉo dum vi laboris pri via branĉo, vi povus antaŭenpuŝi tiujn ĝisdatigojn.

En la sekva diagramo ni povas vidi:

La ĉefa branĉo
Nova branĉo vokis feature
La vojo, kiun la feature plenumas antaŭ esti kunfandita kun ĉefa

Krei branĉon por nova efektivigo aŭ korekto de cimoj estas kiel konservi dosieron. Kun GitHub, programistoj uzas branĉojn por konservi cimojn kaj funkciojn, apartaj de la ĉefa produktadbranĉo. Kiam ŝanĝo estas preta, ĝi estas kunfandita en la ĉefan branĉon.

Ni kreu branĉon

Post krei nian deponejon, movu al la langeto <>Code(1) de la deponejo:

Alklaku la ĉefan (2) falmenuon, kaj poste donu nomon al la nova branch (3)

Alklaku Create branch: first branch from 'main'

Nun ni havas du branch, main e first-branch. Ĝuste nun, ili aspektas tute same. Poste ni aldonos la ŝanĝojn al la nova branch.

Faru kaj konfirmu ŝanĝojn

Ĵus kreis la novan branch, GitHub venigis vin al la code page por la nova first-branch, kiu estas kopio de main.

Ni povas fari kaj konservi ŝanĝojn al dosieroj en la deponejo. En GitHub, konservitaj ŝanĝoj estas nomitaj commit. Ĉiu commit havas mesaĝon de commit asociita, kiu estas priskribo kiu klarigas kial aparta ŝanĝo estis farita. La mesaĝoj de commit ili kaptas la historion de ŝanĝoj por ke aliaj kontribuantoj povu kompreni kio estis farita kaj kial.

Sub la branĉo first-branch kreita, alklaku la dosieron README.md, kaj poste sur la krajonon por redakti la dosieron.

En la redaktilo, skribu uzante Markdown.

En la skatolo Commit changes (Antaŭrigardo), ni skribas mesaĝon de commit priskribante la ŝanĝojn.

Fine alklaku la butonon Commit changes.

Ĉi tiuj ŝanĝoj estos faritaj nur al la dosiero README first-branch, do nun ĉi tiu branĉo enhavas malsaman enhavon ol la ĉefa.

Malfermo de unu pull request

Nun kiam ni havas ŝanĝojn en branĉo de ĉefa, ni povas malfermi unu pull request.

Le pull request ili estas la koro de la kunlaboro en GitHub. Kiam vi malfermas a pull request, vi proponas viajn ŝanĝojn kaj petas iun fari a review e pull de via kontribuo kaj kunfandi ilin en ilia branĉo. La pull request montri la diferencojn de la enhavo de ambaŭ branĉoj. Ŝanĝoj, aldonoj kaj subtrahoj estas montritaj en malsamaj koloroj.

Tuj kiam vi faras kompromison, vi povas malfermi tirpeton kaj komenci diskuton, eĉ antaŭ ol la kodo estas finita.

Uzante la funkcion @mention de GitHub en via afiŝo de pull request, vi povas peti specifajn homojn aŭ teamojn pri sugestoj, sendepende de ilia loko.

Vi eĉ povas malfermi pull request en via deponejo kaj kunfandu ilin mem. Estas bonega maniero lerni la GitHub-rivereton antaŭ ol labori pri pli grandaj projektoj.

Fari unu pull request vi devas:

• Alklaku la langeton pull request de via deponejo first-repository.

• Alklaku New pull request
• En la skatolo Example Comparisons, elektu la branĉon, kiun vi kreis, first-branch, komparenda kun ĉefa (la originalo).
• Revizu viajn ŝanĝojn en la diferencoj sur la paĝo Komparu, certigu, ke ili estas tiuj, kiujn vi volas sendi.

• Alklaku Create pull request.

• Donu titolon al via pull request skribu mallongan priskribon de viaj ŝanĝoj. Vi povas inkluzivi emojis kaj treni kaj faligi bildojn kaj gifojn.

• Laŭvole, dekstre de la titolo kaj priskribo, alklaku apud Recenzistoj. Ricevantoj, Etikedoj, Projektoj aŭ Mejloŝtonoj por aldoni iun el ĉi tiuj opcioj al via pull request. Vi ankoraŭ ne bezonas aldoni ilin, sed ĉi tiuj opcioj ofertas plurajn manierojn kunlabori uzante vian pull request.
• Alklaku Create pull request.

Viaj kunlaborantoj nun povas revizii viajn ŝanĝojn kaj fari sugestojn.

Kunfandi la vian pull request

En ĉi tiu fina paŝo, vi kunfandos vian branĉon first-branch en la ĉefa branĉo. Post kunfandi la pull request, ŝanĝoj al la branĉo first-branch estos enigita en la dosiero ĉefa.

Foje, tira peto povas enkonduki kodŝanĝojn kiuj konfliktas kun ekzistanta kodo ĉe ĉefa. Se estas konfliktoj, GitHub avertos vin pri la konflikta kodo kaj malhelpos la kunfandiĝon ĝis la konfliktoj estos solvitaj. Vi povas fari devontigon, kiu solvas la konfliktojn aŭ uzi la komentojn en la tira peto por diskuti la konfliktojn kun viaj teamanoj.

• Alklaku Merge pull request kunfandi la ŝanĝojn en ĉefan.

• Alklaku Confirm merge. Vi ricevos mesaĝon, ke la peto estis sukcese kunfandita kaj la peto estis fermita.
• Alklaku Delete branch. Nun ke via richiesta pull estas kunfandita kaj viaj ŝanĝoj estas en ĉefa, vi povas sekure forigi la branĉon first-branch. Se vi volas fari pliajn ŝanĝojn al via projekto, vi ĉiam povas krei novan branĉon kaj ripeti ĉi tiun procezon.

Ercole Palmeri