Makabo nto contribution ya Liboso

Ezalaka ntango nyonso mpasi mpo na moto kosala eloko moko mpo na mbala ya liboso. Kobanga kosala mabunga nto erreurs ezalaka malamu te, mingimingi ntango ozali kosala mosala elongo na bato mosusu. Kasi mokili ya logiciel libre ezali likambo ya kosala mosala elongo mpe kosala na kati ya etuluku nto groupe. Yango wana, tolingi kopesa nzela ya pete mpo na baye bazali kobanda kopesa makabo nto mpe contribution na logiciel libre na koteya bino ndenge ya kosala contribution mpo na mbala ya liboso.

Kotánga ba articles mpe ba tutoriels ekoki kosalisa, kasi nini eleki malamu koleka komeka na kozanga kobanga kosala mabunga nto mpe erreur? Projet oyo ezali na mokano ya kopesa toli mpe kopesa nzela ya pete mpo na ndenge bayekoli bakoki kopesa contribution na bango ya liboso. Kobosana te: soki ozali na kimya mingi, okoyekola malamu. Soki olingi kopesa makabo nto mpe contribution na yo ya liboso, landa kaka ba étapes oyo ezali awa na nse. Nalaki yo, ekozala esengo.

Soki ozali naino na Git te na machine na yo, installe-yango .

Kosala fork ya dépôt oyo

Sala fork ya dépôt oyo na kokliké na bouton fork neti elakisami na bilili oyo likoló. Yango ekosala copie ya dépôt oyo na compte na yo moko ya GitHub.

Kosala clone ya répertoire oyo

Sikoyo, sala clone ya répertoire oyo na ordinateur na yo. Kende na compte na yo ya GitHub, fungola dépôt oyo osali fork, kliké na bouton Code, na nsima na onglet SSH mpe na nsuka na icône copier dans le presse-papier.

Fungola invite de commande (soki ozali na Windows) to terminal (soki ozali na MacOS to Linux) mpe sala commande git oyo elandi:

Okoki mpe koinstallé Git bash na Windows nayo soki

git clone "lien ya repertoire oyo okopié"

esika "lien ya repertoire oyo okopié" (longola ba guillemets) ezali url ya dépôt oyo osali fork. Talá lisusu ba étapes ya liboso mpo na kozwa URL ya solo.

Na ndakisa:

git clone https://github.com/kombo-na-yo-ya-utilisateur/first-contributions.git

esika kombo-na-yo-ya-utilisateur ezali kombo na yo ya utilisateur ya GitHub. Awa ozali kokopié ba contenus ya dépôt first-contributions uta na GitHub na ordinateur na yo.

Kosala branche moko

Kende na répertoire ya projet oyo osili kosala clone (soki ozali naino na kati te):

cd first-contributions

Sikoyo sala branche moko na commande git checkout:

git checkout -b <tia-kombo-na-yo>

Na ndakisa:

git checkout -b add-emmanuel-binen

(Kombo ya branche kozala na kozala na liloba add ezali ya mutuya te, kasi ezali malamu koyekola yango mpo tina ya branche oyo ezali mpo na kobakisa kombo na yo na liste.)

Soki okutani na libunga na git switch, kliká awa:

Soki message "Git: switch is not a git command. See git –help" ebimi, ezali mpo ozali kosalela version ya kala ya Git.

Na likambo yango, meká nde:

git checkout -b kombo-ya-branche-na-yo-ya-sika

Sala ba modifications oyo esengeli mpe enregistrer yango

Fungola fichier Contributors.md na éditeur ya texte, bakisá kombo na yo kuna, mpe enregistrer yango. Kobakisa yango te na ebandeli to na nsuka ya fichier, kasi esika moko na katikati.

Soki ofungoli terminal de commande mpe osali commande git status, okomona ete ezali na ba modifications. Bakisá ba modifications yango na branche oyo osili kosala na commande git add:

git add Contributors.md

Sikoyo sala commit ya ba modifications yango na commande git commit:

git commit -m "Add <kombo-na-yo> to Contributors list"

longola <kombo-na-yo> mpe bakisa kombo na yo moko.

Tinda ba modifications na GitHub

Pusa ba modifications na yo na commande git push:

git push -u origin <kombo-ya-branche-na-yo>

longola makomi oyo <kombo-ya-branche-na-yo> mpe tia kombo ya branche oyo osili kosala.

Soki ozwi ba erreurs ntango ya kopusa ba modifications, kliké awa:

Erreur ya authentification

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/'

Landa tutoriel ya GitHub mpo na kosala mpe ko configurer clé SSH na compte na yo.

Okoki mpe kosala git remote -v mpo na kotala adresse na yo ya mosika.

Soki ezali lokola oyo:

origin https://github.com/kombo-na-yo-ya-utilisateur/ton_repo.git (fetch) origin https://github.com/kombo-na-yo-ya-utilisateur/ton_repo.git (push)

Bongisa yango na commande oyo:

git remote set-url origin git@github.com:kombo-na-yo-ya-utilisateur/ton_repo.git

Soki te, okokoba komona kokɔtisa mot de passe na yo mpe na suka okozua erreur ya authentification.

Tinda contribution na yo mpo na kotala

Soki okeyi na répertoire na yo na Github, okomona bouton Compare & pull request. Kliké na yango.

Na nsima, tinda pull request.

Nakotia ba modifications na yo na branche principale ya projet kala mingi te. Sima okozwa e-mail ya confirmation soki yango esalemi.

Branche main ya dépôt na yo oyo osali fork ekobongwana te. Mpo ete dépôt na yo ezala synchronisé na ya ngai, landa ba étapes oyo elandi.

Tiká fork na yo ezala synchronisé na répertoire oyo

Ya liboso, kende na branche main

git checkout main

Mpe bakisá url ya répertoire na ngai lokola upstream remote url:

git remote add upstream https://github.com/Emmanuelbinen/first-contributions

Oyo ezali lolenge moko ya koyebisa git ete version mosusu ya répertoire oyo ezali na adresse oyo epesami mpe tobengi yango upstream. Soki ba modifications esili kosangisama, luká version ya sika ya répertoire na ngai:

git fetch upstream

Awa tozali koluka ba modifications nyonso na fork na ngai (upstream remote). Sikoyo, osengeli kosangisa version ya sika ya répertoire na ngai na branche main na yo:

git rebase upstream/main

Awa tozali kosalela ba modifications nyonso oyo ozwi na branche main. Soki opusi branche main sikoyo, fork na yo mpe ekozala na ba modifications:

git push origin main

Keba: Mbala oyo, ozali kopusa ba modifications na répertoire ya mosika oyo babengi origin.

Na ntango oyo nasangisi branche na yo <add-kombo-na-yo> na branche na ngai main, mpe osangisi branche na ngai main na branche na yo main. Branche na yo <add-kombo-na-yo> ezali lisusu na ntina te, yango wana okoki kolongola yango:

git branch -d <add-kombo-na-yo>

mpe okoki kolongola version na naye uta répertoire ya mosika mpe:

git push origin --delete <add-kombo-na-yo>

Oyo ezali ya ntina te, kasi kombo ya branche emonisi ete mokano nto objectif na yango ezali ya sikisiki nto polelepolele. Bomoi na yango ekoki kozala mokuse.