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.
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:
New repository
.first-repository
.Create repository
.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.
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
.
Ĵ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.
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:
pull request
de via deponejo first-repository
. New pull request
Example Comparisons
, elektu la branĉon, kiun vi kreis, first-branch
, komparenda kun ĉefa (la originalo).Create pull request
.pull request
skribu mallongan priskribon de viaj ŝanĝoj. Vi povas inkluzivi emojis kaj treni kaj faligi bildojn kaj gifojn.pull request
. Vi ankoraŭ ne bezonas aldoni ilin, sed ĉi tiuj opcioj ofertas plurajn manierojn kunlabori uzante vian pull request
. Create pull request
.Viaj kunlaborantoj nun povas revizii viajn ŝanĝojn kaj fari sugestojn.
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.
Merge pull request
kunfandi la ŝanĝojn en ĉefan.Confirm merge
. Vi ricevos mesaĝon, ke la peto estis sukcese kunfandita kaj la peto estis fermita.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
Pasintlunde, la Financial Times anoncis interkonsenton kun OpenAI. FT licencas sian mondklasan ĵurnalismon...
Milionoj da homoj pagas por streaming-servoj, pagante monatajn abonkotizojn. Estas komuna opinio, ke vi...
Coveware de Veeam daŭre liveros servojn de respondaj incidentoj pri ciberĉantaĝo. Coveware ofertos krimmedicinajn kaj solvajn kapablojn...
Prognoza prizorgado revolucias la petrolon kaj gasan sektoron, kun noviga kaj iniciatema aliro al plantadministrado...