Deltag i den sociale kodningstrend og bidrager til GitHub-arkiver

Har du nogensinde fundet en pakke på GitHub, du har haft, men ønskede at tilføje en hurtig funktion, rette en fejl, du fandt, eller måske bare bidrage til open source som helhed? Deltag i trenden med social kodning, del dine færdigheder og hjælp til gavn for open source-verdenen. I denne artikel lærer du alt om, hvordan du kan bidrage med kode til et lager på GitHub eller enhver hostet git-tjeneste.

Få opsætning

Denne artikel antager, at du allerede har en GitHub-konto, men hvis ikke, bedes du hurtigt tilmeld dig en gratis konto. Sørg også for, at du allerede har git installeret ved at køre følgende kommando i terminalen:

git --version

Hvis du i stedet for at se versionsnummeret får en meddelelse om "kommando ikke fundet", kan du installere git med kommandoen:

sudo apt-get -y installer git

Gaffel lageret

Først skal du vælge det lager, du vil bidrage til, og besøge det i din webbrowser. Hvis du er i tvivl om, hvilket lager du skal vælge, kan du bruge demo-lageret på https://github.com/mdizak/muo_demo

. Dette er en simpel demo, og du er velkommen til at oprette pull-anmodninger mod den til test- og læringsformål.

Mens du ser arkivet i din webbrowser, skal du kigge efter Gaffelopbevaring og klik på den. Dette forkaster arkivet til din egen GitHub-konto og bringer dig til det. Derefter skal du klon det for nylig gaffelformerede arkiv, så åbn terminalen på din lokale computer, og kør:

Sådan klones et lager ved hjælp af GitHub Desktop

Vil du få styr på software på GitHub? Sådan gør du det øst med det strømlinede GitHub Desktop-værktøj.

git klon https://github.com/myusername/muo_demo.git
cd muo_demo

Sørg naturligvis for, at du ændrer ovennævnte URL til din for nylig gaffelregister. Når du er klonet, skal du tilføje det originale lager som en opstrøms med kommandoen:

git remote add upstream https://github.com/mdizak/muo_demo.git

Sørg for at ændre URL'en i ovenstående kommando med den for det originale lager, du klonede. Dette betyder, at git er, at det er et overordnet lager, hvorfra du arbejder på.

Forbered Local Repository

Hver gang inden du begynder at arbejde på et nyt bidrag, skal du sikre dig, at du kører den nyeste kodebase i det overordnede arkiv. Kør følgende kommandoer i terminalen i projektmappen:

git checkout master
git pull upstream master && git push origin master

Den første kommando sikrer, at du i øjeblikket arbejder i mastergrenen, og den anden kommando synkroniserer det overordnede arkiv med både dine lokale og GitHub-arkiver. Dette sikrer, at du ændrer den mest opdaterede kodebase og ikke arbejder med forældet kode.

Sørg også for at kontrollere, om projektet har enribute.md-fil, og i så fald skal du sørge for at følge det, der står. Nogle gange har projekter specifikke retningslinjer for, hvordan man leverer bidrag, som altid skal følges.

Opret en ny filial

Du er nødt til at oprette en ny gren, der indeholder alle ændringer til dette bidrag, som senere bliver flettet ind i hoved GitHub-arkivet af projektvedligeholdere. Filialen skal være alfanumerisk og kan navngives alt, hvad du ønsker.

Selvom det ikke kræves, betragtes det generelt som almindelig høflighed at forud for filialens navn med hotfix / for hurtige fejlrettelser eller funktion / for ekstra funktioner. Vælg det ønskede filialnavn, og kør kommandoen:

git checkout -b-funktion / my_cool_feature

Du skal altid oprette en separat gren for hver funktion / bug fix og aldrig medtage flere bidrag i en. Dette hjælper med at opretholde en jævn udviklingsstrøm og hjælper også med at sikre, at dit bidrag accepteres og indgår i projektet.

Nu hvor din filial er oprettet, skal du fortsætte og udføre de nødvendige ændringer, du gerne vil have med standard git-arbejdsprocessen.

Forpligt dig og opret trækanmodning

Når du har afsluttet arbejdet med dit bidrag, skal du forpligte det med et korrekt begå besked og skub det til dit forked-arkiv med kommandoerne:

git commit --fil commit.txt
git push -u oprindelsesfunktion / my_cool_feature

Det sidste trin er at oprette en pull-anmodning, der advarer projektholderne om, at et nyt bidrag afventer. Besøg det forgrenede GitHub-lager i din webbrowser, og du vil se en rullemenu, der giver dig mulighed for at skifte filial. Skift til din nyoprettede gren, og den næste side indeholder et link, der giver dig mulighed for at oprette en ny pullanmodning.

Når du klikker på dette link, vil du se en side, der viser din forpligtelsesmeddelelse og alle ændringer, du har foretaget inden for koden. Gennemgå alt for at sikre, at det er korrekt, tilføj enhver nødvendig yderligere besked til vedligeholdere, og send pull-anmodningen.

Fortsæt med at bidrage til GitHub

Tillykke, du har med succes indsendt et bidrag til et GitHub-projekt!

Din pull-anmodning afventer nu gennemgang og godkendelse af projektholderne, og du vil blive underrettet via e-mail, om den blev godkendt eller ej, og med de meddelelser, de har til dig. Nu hvor du har lært at bidrage til projekter på GitHub, fortsæt med at komme videre og hjælpe med at vokse open source-samfund.

Sådan tilføjes mere RAM til din Android-enhed med et MicroSD-kort

Hvis din Android-telefon eller -tablet kører lidt langsomt, har det muligvis bare brug for lidt mere RAM. Vi kan hjælpe med det.

Om forfatteren