Minden kezdet nehéz, ezért szeretnénk segíteni számodra az első lépésekben ahhoz, hogy bátran kódolj koóperatívan nyilt forráskodú projekteket. Senki sem szeret hibázni, de szerencsére itt most nyugodtan megteheted. A lényeg, hogy gyakorolj!
A projekt célja, hogy útmutatást nyújtson, egyszerűsítse és segítse a kezdők első lépéseit nyilt forráskódú szoftverek közös programozásában. Ha te is most készülsz először ilyet csinálni, segítünk neked, kövessd az alábbi lépéseket.
Ha a parancssor kényelmetlen, itt egy tutorial a GUI felület használatához.
Ha nincs a gépeden git, telepítsd fel.
A Fork gomb kattintásával ágaztasd el ezt a repot. Készíteni fog egy másolatot erről a reporól a te saját git fiókodba.
Most klónozd az elágaztatott repot a gépedre. Menj a GitHub fiókodra, nyisd meg a forkolt repositoryt, kattints a clone gombra, majd kattints a copy to clipboard ikonra.
Nyiss egy terminált és futtasd a következő parancsot:
git clone "url you just copied"
a "url you just copied" kifejezést, cseréld ki (idézőjelek nélkül) a vágólapra helyezett repository url címére (ami ebből a projektől ágazik). Az ágaztatás folyamatát lásd az előző lépésben.
Például:
git clone https://github.com/a-te-git-neved/first-contributions.git
a a-te-git-neved
lesz a GitHub felhasználóneved. Ezzel letöltöd a first-contributions repositoryt GitHub-ról a saját számítógépedre.
Navigálj a repository könytárába (ha nem ott vagy jelenleg):
cd first-contributions
Most készítsünk egy ágat git checkout
parancs használatával:
git checkout -b <add-your-new-branch-name>
Például:
git checkout -b add-gabor-takacs
(A branch nevében nem kötelező, hogy benne legyen az add szó, de ésszerű belefoglalni, mert ennek az ágnak az a célja, hogy hozzáadja a nevünket egy listához.)
Nyisd meg a Contributors.md
fájlt egy szövegszerkesztőben, majd add hozzá a neved. Ne a fájl elejére vagy végére helyezd, hanem a kettő közé. A kettő között bárhová teheted. Mentsd el a fájlt.
Ha a project könyvtárába navigálsz és futtatod a git status
parancsot, akkor a következő módosításokat fogod látni:
Ezeket a módosításokat add hozzá a branchez a git add
paranccsal:
git add Contributors.md
Commitoljuk a módosításokat a git commit
paranccsal:
git commit -m "Add <your-name> to Contributors list"
helyettesítsd <your-name>
kifejezést a saját neveddel.
Töltsd fel a változtatásokat a git push
paranccsal:
git push origin <add-your-branch-name>
helyettesítsd az <add-your-branch-name>
kifejezést annak a branchnek a nevével, amit korábban létrehoztál.
Ha a saját repodba navigálsz GitHub-on, látnod kell a Compare & pull request
gombot. Kattints rá!
Sikeresen elküldted a pull requested.
Kis idő elteltével összevonja a változásokat a project fő ágában. Értesítést fogsz kapni emailben, ha a változások összefűzésre kerültek.
Gratulálunk! Sikeresen teljesítetted az alapvető fork -> clone -> edit -> PR folyamatot, melyet gyakran kell majd csinálnod közreműködőként!
Ünnepeld meg az első kooperációdat és osszd meg barátaidall és követőiddel ennek a web app-nak a segítségével.
Bármilyen kérdésed van vagy segítségre lenne szükséged, csatlakozz slack csapatunkhoz. Csatlakozz a slack csapathoz..
Itt az idő egy másik projektben is közreműködni. Összeállítottunk egy listát azokról a projektekről, melyek könnyebb feladatokat tartalmaznak az induláshoz. Nézd meg a projektek listáját a webalkalmazásban.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree |