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

instagram viewer
. 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:

Hvordan klone et lager ved hjelp av GitHub Desktop

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.

E-post
Slik legger du til mer RAM til Android-enheten din med et MicroSD-kort

Hvis Android-telefonen eller nettbrettet kjører litt sakte, trenger det kanskje bare litt mer RAM. Vi kan hjelpe til med det.

Relaterte temaer
  • Programmering
  • GitHub
Om forfatteren
Matt Dizak (11 artikler publisert)Mer fra Matt Dizak

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.

.