Minden kezdet nehéz, ezért szeretnénk segíteni számodra az első lépésekben ahhoz, hogy bátran kódolj kooperatívan nyílt 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 nyílt 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övesd 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 repót. Ezzel készítettél egy másolatot erről a reporól a te saját git fiókodba.
Most klónozd az elágaztatott repót 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-amit-most-masoltal-le"
A "url-amit-most-masoltal-le" 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 switch -c <az-uj-branch-neve>
Például:
git switch -c add-gabor-takacs
(A branch nevében nem kötelező, hogy benne legyen az add szó, de észszerű 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 <a-te-neved> to Contributors list"
Helyettesítsd <a-te-neved>
kifejezést a saját neveddel.
Töltsd fel a változtatásokat a git push
paranccsal:
git push origin <a-branch-neve>
Helyettesítsd az <a-branch-neve>
kifejezést annak a branchnek a nevével, amit korábban létrehoztál.
Ha a saját repódba 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 oszd meg barátaiddal é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 | IntelliJ IDEA |