Har du noen gang funnet en pakke på GitHub du likte, men ønsket å legge til en rask funksjon, fikse en feil du fant, eller kanskje bare bidra til åpen kildekode som helhet? Bli med i trenden med sosial koding, del dine ferdigheter og dra nytte av åpen kildekodeverden. I denne artikkelen kan du lære mer om hvordan du kan bidra med kode til et depot på GitHub, eller en hvilken som helst hostet git-tjeneste.
Få installasjon
Denne artikkelen antar at du allerede har en GitHub-konto, men hvis ikke, vær så snill registrer deg for en gratis konto. Sørg også for at du allerede har git installert ved å kjøre følgende kommando i terminalen:
git --versjon
Hvis du får en "kommando ikke funnet" -melding i stedet for å se versjonsnummeret, kan du installere git med kommandoen:
sudo apt-get -y installer git
Gaffel depotet
Først må du velge depotet du vil bidra til, og besøke det i nettleseren din. Hvis du er usikker på hvilket depot du skal velge, kan du bruke demo-depotet på https://github.com/mdizak/muo_demo
. Dette er en enkel demo, og du er velkommen til å lage pull-forespørsler mot den for test- og læringsformål.Mens du ser på depotet i nettleseren din, se etter Gaffellager og klikk på den. Dette vil forkaste depotet til din egen GitHub-konto og bringe deg til det. Neste må du klone det nylig gaffelte arkivet, så åpne terminalen på din lokale datamaskin og kjør:
Vil du ta tak i programvaren på GitHub? Slik gjør du det østover med det strømlinjeformede GitHub Desktop-verktøyet.
git klon https://github.com/myusername/muo_demo.git
cd muo_demo
Sørg naturligvis for at du endrer URL-adressen ovenfor til den for nylig gaffelregisteret ditt. Når du er klonet, legger du til det opprinnelige depotet som en oppstrøms med kommandoen:
git remote add upstream https://github.com/mdizak/muo_demo.git
Sørg for å endre URL-en i kommandoen ovenfor med den til det opprinnelige depotet du klonet. Dette betyr at det er et overordnet depot du jobber med.
Forbered Local Repository
Hver gang før du begynner å jobbe med et nytt bidrag, må du sørge for at du kjører den nyeste kodebasen i det overordnede arkivet. Kjør følgende kommandoer i terminalen i prosjektkatalogen:
git checkout master
git pull upstream master && git push origin master
Den første kommandoen sikrer at du for øyeblikket jobber i hovedgrenen, og den andre kommandoen synkroniserer det overordnede arkivet med både ditt lokale og GitHub-arkiv. Dette sikrer at du endrer den mest oppdaterte kodebasen, og ikke jobber med utdatert kode.
Sørg også for å sjekke om prosjektet har enribute.md-fil, og i så fall må du følge med i hva det står. Noen ganger har prosjekter spesifikke retningslinjer for hvordan du kan gi bidrag, som alltid skal følges.
Opprett en ny gren
Du må opprette en ny gren som vil inneholde alle modifikasjoner for dette bidraget, som senere blir slått sammen til hoved GitHub-arkivet av prosjektansvarlige. Filialen må være alfanumerisk og kan hete alt du måtte ønske.
Selv om det ikke kreves, er det generelt ansett som vanlig høflighet å prefiks avdelingens navn med hurtigreparasjon / for raske feilrettinger eller trekk/ for ekstra funksjoner. Velg ønsket filialnavn, og kjør kommandoen:
git checkout -b-funksjon / my_cool_feature
Du bør alltid opprette en egen gren for hver funksjon / feilretting, og aldri inkludere flere bidrag i en. Dette bidrar til å opprettholde en jevn utviklingsflyt, og bidrar også til at ditt bidrag blir akseptert og inkludert i prosjektet.
Nå som filialen din er opprettet, kan du fortsette og fullføre de nødvendige endringene du ønsker med standard git-arbeidsflyten.
Forplikte og opprette trekkforespørsel
Når du har fullført arbeidet med ditt bidrag, kan du forplikte det med en riktig begå melding og skyv den til gaffelarkivet ditt med kommandoene:
git commit --file commit.txt
git push -u origin funksjon / my_cool_feature
Det siste trinnet er å opprette en pull-forespørsel som varsler prosjektansvarlig om at et nytt bidrag venter. Besøk det forgrenede GitHub-depotet i nettleseren din, så ser du en rullegardinknapp som lar deg bytte gren. Bytt til den nyopprettede grenen din, og neste side inneholder en lenke som lar deg lage en ny pull-forespørsel.
Når du klikker på lenken, vil du se en side som viser forpliktelsesmeldingen din og alle endringene du har gjort i koden. Gjennomgå alt for å sikre at det er riktig, legg til eventuell nødvendig tilleggsmelding til vedlikeholdere, og send inn pull-forespørselen.
Fortsett å bidra til GitHub
Gratulerer, du har sendt inn et bidrag til et GitHub-prosjekt!
Din pull-forespørsel venter nå på gjennomgang og godkjenning av prosjektansvarlige, og du vil bli varslet via e-post om den ble godkjent eller ikke, og med eventuelle meldinger de har for deg. Nå som du har lært hvordan du kan bidra til prosjekter på GitHub, fortsett fremover og bidra til å utvide åpen kildekode.
Hvis Android-telefonen eller nettbrettet kjører litt sakte, trenger det kanskje bare litt mer RAM. Vi kan hjelpe til med det.
- Programmering
- GitHub
Abonner på vårt nyhetsbrev
Bli med på vårt nyhetsbrev for tekniske tips, anmeldelser, gratis e-bøker og eksklusive tilbud!
Ett steg til…!
Bekreft e-postadressen din i e-posten vi nettopp sendte deg.