Pirmieji įnašai

Sunku. Visada sunku ką nors padaryti pirmą kartą. Ypač bendradarbiaujant, klaidų darymas nėra malonus dalykas. Tačiau atviras kodas - tai bendravimas ir bendradarbiavimas. Mes norime paprasčiau paaiškinti naujiesiems atvirojo kodo kūrėjams, kaip jie gali prisidėti pirmą kartą.

Galite pradėti skaityti straipsnius ir žiūrėti vadovus, bet kas gali būti geriau nei mokymasis darant be klaidų pirmą kartą? Šio projekto tikslas - suteikti patarimus ir supaprastinti tai, kaip naujokai atlieka savo pirmąjį indėlį. Prisiminkite: kuo labiau atsipalaidavę esate, tuo geriau mokotės. Jei norite atlikti pirmąjį indėlį, atlikite toliau pateiktus paprastus veiksmus. Mes pažadame, tai bus smagu.

Jei nesate pratę dirbti su komandine eilute, čia rasite vadovą, naudojantį GUI įrankius.

Jei neturite instaliuoto git, instaliuokite čia.

Kopijuokite (fork) šią saugyklą

Kopijuokite saugyklą paspausdami šaknies simbolio mygtuką šio puslapio viršuje. Tai sukurs šios saugyklos kopiją jūsų GitHub paskyroje.

Klonuokite saugyklą

Dabar klonuokite šią saugyklą į savo kompiuterį. Spustelėkite klonavimo mygtuką ir tada spustelėkite copy to clipboard piktogramą.

Atidarykite terminalą ir paleiskite šią git komandą:

git clone "kątik nukopijuota nuoroda"

kur "kątik nukopijuota nuoroda" (be citatos ženklų) yra url nuoroda jūsų saugyklai (jūsų projekto kopijai). Peržiūrėkite ankstesnius veiksmus, kad gautumėte url nuorodą.

Pavyzdžiui:

git clone https://github.com/tai-jus/first-contributions.git

kur tai-jus yra jūsų GitHub paskyros vartotojo vardas. Čia jūs kopijuojate first-contributions saugyklos turinį į "GitHub" aplanką savo kompiuteryje.

Sukurkite šaką (branch)

Pakeiskite kompiuterio saugyklos katalogą (jei dar to nepadarėte anksčiau):

cd first-contributions

Dabar sukurkite šaką naudodami komandą git branch:

git branch -c <tavo-sakos-vardas>

Pavyzdžiui:

git branch -c add-vardenis-pavardenis

(Saugyklos pavadinime neprivalo būti žodžio add, bet mes jį naudojame, kadangi šios šakos (branch) paskirtis yra įtraukti savo vardą į sąrašą.)

Jei gavote klaidos pranešimą naudodami git switch, spauskite čia:

Jei klaidos pranešimas yra "Git: switch is not a git command. See git –help", tikėtinai naudojate seną git versiją.

Tokiu atveju bandykite git checkout:

git checkout -b add-vardenis-pavardenis

Atlikite reikiamus pakeitimus ir pridėkite (commit) šiuos pakeitimus

Dabar atidarykite failą Contributors.md teksto redaktoriuje ir pridėkite prie jo savo vardą. Nedėkite jo į failo pradžią ar pabaigą - įrašykite jį bet kur kitur faile. Galiausiai, išsaugokite failą.

Jei eisite į projekto katalogą ir paleisite komandą git status, pamatysite, kad yra pakeitimų. Pridėkite šiuos pakeitimus į ką tik sukurtą šaką (branch) komandos git add pagalba:

git add Contributors.md

Dabar atlikite šiuos pakeitimus naudodami komandą git commit:

git commit -m "Add <tavo-vardas> to Contributors list"

pakeisdami <tavo-vardas> savo vardu.

Išsiųskite pakeitimus į GitHub

Išsiųskite pakeitimus komanda git push:

git push origin <tavo-sakos-vardas>

pakeisdami <tavo-sakos-vardas> anskčiau sukurtos šakos (branch) vardu.

Jei gaunate klaidos pranešimą išsaugodami pakeitimus, spauskite čia:

Autentifikacijos klaida

remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
fatal: Authentication failed for 'https://github.com//first-contributions.git/'

GitHub vadovas padės jums sugeneruoti ir sukonfiguruoti SSH raktą savo paskyroje.

Taip pat, galbūt norėsite pabandyti 'git remote -v', skirtą patikrintite savo nuotolinį adresą (remote address).

Jei jis atrodo taip ar panašiai:

origin	https://github.com/your-username/your_repo.git (fetch)
origin	https://github.com/your-username/your_repo.git (push)

pakeiskite jį, naudodami komandą:

git remote set-url origin git@github.com:your-username/your_repo.git

Kitu atveju jūsų vis tiek sulauksite klausimo apie savo vartotojo vardą ir slaptažodį ir sulauksite autentifikacijos klaidos.

Pateikite pakeitimus peržiūrai

Eikite į savo saugyklą GitHub. Pamatysite mygtuką Compare & pull request (palyginti ir įtraukti užklausą). Spustelėkite šį mygtuką.

Dabar pateikite įtraukimo į pradinę saugyklą (pull) užklausą.

Netrukus projekto autorius sujungs visus jūsų šakos pakeitimus su šio projekto pagrindine šaka. Kai pakeitimai bus sujungti, gausite tai patvirtinantį el. laišką.

Kas toliau?

Džiaukitės ir atkreipkite dėmesį į savo įnašą pasidalindami šia žinia su draugais interneto aplikacijoje.

Pradėkite tobulinti kitus projektus. Mes sukūrėme projektų sąrašą, kuriuose yra lengvai išsprendžiamų problemų. Peržiūrėkite projektų sąrašą interneto aplikacijoje.