Vsak začetek je težak. Ko sodeluješ z drugimi, so napake še veliko bolj neprijetne. Zato smo se odločili, da novincem olajšamo prispevanje k odprti kodi (ang. Open source).
Branje člankov in sledenje vodičem lahko pomaga, vendar je še vedno najbolje da nove veščine vadimo sami v varnem okolju. Namen tega projekta je da novince vodi in jim olajša prvi prispevek k odprti kodi. Če želite narediti prvi prispevek, sledite spodnjim korakom.
Angleški izrazi so v oklepajih, da dodajo kontekst vsebini.
Če se ne počutite dobro v ukazni vrstici (ang. command line), so tukaj navodila za uporabo orodij z grafičnim vmesnikom.
Preberite ta navodila v drugih jezikih.
🇮🇳 🇲🇲 🇮🇩 🇫🇷 🇪🇸 🇳🇱 🇷🇺 🇯🇵 🇻🇳 🇵🇱 🇮🇷 🇮🇷 🇰🇷 🇰🇵 🇩🇪 🇨🇳 🇹🇼 🇬🇷 🇺🇦 🇧🇷 🇵🇹 🇮🇹 🇹🇭 🏴 🇵🇰 🇧🇩 🇲🇩 🇷🇴 🇹🇷 🇸🇪 🇮🇱
Če na svojem računalniku še nimaš "git", si ga naloži.
S pritiskom na gumb "Fork" na vrhu te strani, ustvari svojo različico repositorya ( pogosto skrajšano v "repo" ) v svojem GitHub računu.
Sedaj kloniraj ta repository na svoj računalnik. Pojdi v svoj GitHub račun in poišči svojo različico tega repositorya, klikni na gumb "Clone or download" in si kopiraj povezavo. Lahko uporabiš "Ctrl+C" ali pa klikni na ikono na desni strani povezave copy to clipboard.
Odpri terminal in se postavi v direktorij, v katerem želiš imeti svojo kopijo repositorya. Nato zaženi naslednji ukaz:
git clone "url naslov, ki si ga ravno skopiral""url naslov, ki si ga ravno skopiral" (brez navednic) je naslov, ki si ga skopiral na Githubu ( naslov tvoje različice projekta ). Glej prejšne korake da dobiš url naslov.
Primer:
git clone https://github.com/this-is-you/first-contributions.gitthis-is-you je tvoje GitHub uporabniško ime. Ta ukaz skopira vsebino repositorya "first-contributions" z GitHuba v tvoj računalnik.
Prestavi se v direktorij repositorya na svojem računalniku (če še nisi v njem):
cd first-contributionsSedaj ustvari vejo z uporabo ukaza git checkout:
git checkout -b <add-your-new-branch-name>Primer:
git checkout -b add-janez-novak(Ni potrebno da je v imenu veje add, vendar je v tem primeru smiselno, ker je namen veje da dodaš svoje ime na seznam.)
Odpri datoteko Contributors.md v urejevalniku besedila in dodaj svoje ime. Ne dodajaj ga na začetek ali konec datoteke, dodaj ga nekje vmes. Shrani datoteko.
Če se postaviš v direktorij projekta in izvedeš ukaz git status, vidiš da obstajajo spremembe v projektu.
Dodaj te spremembe veji, ki si jo ravno ustvaril, z ukazom git add:
git add Contributors.mdSedaj izvedi commit teh sprememb z ukazom git commit:
git commit -m "Add <your-name> to Contributors list"Zamenjaj <your-name> s svojim imenom. Tekst med navednicami je komentar spremembe, ki se shrani s spremembo.
Pošlji svoje spremembe z ukazom git push:
git push origin <add-your-branch-name>Zamenjaj <add-your-branch-name> z imenom veje, ki si jo ustvaril.
Če preveriš svoj repository na GitHubu, vidiš gumb Compare & pull request. Klikni na ta gumb.
Sedaj izvedi submit svojega pull requesta.
Kmalu bom združil tvoje spremembe v master vejo tega projekta. V svoj e-poštni nabiralnik boš dobil sporočilo, da so bile spremembe združene.
Potem, ko so bile tvoje spremembe združene, lahko brez skrbi zbrišeš svojo vejo ''. Videl boš gumb s katerim se zbriše veja:
Če je bila združitev zavrnjena, te bo GitHub opozoril preden zbrišeš nezdružen commit. Gumb bo izgledal takole:
Čestitke! Pravkar si končal običajni fork -> clone -> edit -> PR potek dela, ki ga boš srečal kot sodelavec v odprto kodnih projektih!
Lahko se pridružiš naši slack ekipi, če rabiš pomoč ali imaš vprašanja. Pridruži se slack ekipi.
Sedaj lahko začneš prispevati drugim projektom. Sestavili smo seznam projektov z enostavnimi problemi (issues), ki jih lahko začneš reševati. Preveri seznam projektov v spletni aplikaciji.
 |
 |
 |
|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken |
