9.8 KiB
Primele Contribuții
Acest proiect își propune să simplifice și să îndrume modul în care începătorii își fac prima contribuție. Dacă doriți să faceți prima contribuție, urmați pașii de mai jos.
Dacă nu vă simțiți confortabil folosind linia de comandă, aici sunt tutoriale folosind alte unelte (GUI).
Dacă nu ai git instalat, instalează-l.
Realizați bifurcația depozitului
Efectuați bifurcația acestui depozit apăsând pe butonul Fork din partea de sus a acestei pagini.
Aceasta va crea o copie a acestui depozit în contul dvs.
Clonați depozitul
Acum clonați depozitul bifurcat pe computerul dvs. Mergeți în contul dvs. GitHub, deschideți depozitul bifurcat, apăsați pe butonul Code și apoi pe pictograma de copiere în clipboard.
Deschideți un terminal și executați următoarea comandă Git:
git clone "URL-ul pe care l-ați copiat"
unde URL-ul pe care l-ați copiat (fără ghilimele) este URL-ul către acest depozit (bifurcarea dvs. a acestui proiect). Consultați pașii anteriori pentru a obține URL-ul.
De exemplu:
git clone https://github.com/numele-tau/first-contributions.git
unde numele-tau reprezintă numele dvs. de utilizator GitHub. Aici copiați conținutul depozitului first-contributions de pe GitHub pe computerul dvs.
Creați o ramură
Schimbați directorul depozitului de pe computerul dvs. (dacă nu sunteți deja acolo):
cd first-contributions
Acum creați o ramură folosind comanda git switch:
git switch -c numele-noii-ramuri
De exemplu:
git switch -c adaug-alonzo-church
Efectuați modificările necesare și comiteți acele modificări
Acum deschideți fișierul Contributors.md într-un editor de text, adăugați-vă numele în el. Nu-l adăugați la începutul sau la sfârșitul fișierului. Puneți-l oriunde între acestea. Apoi, salvați fișierul.
Dacă mergeți în directorul proiectului și executați comanda git status, veți vedea că există modificări.
Adăugați aceste modificări în ramura pe care tocmai ați creat-o folosind comanda git add:
git add Contributors.md
Acum comiteți acele modificări folosind comanda git commit:
git commit -m "Adaug numele-tau la lista de Contribuitori"
înlocuind numele-tau cu numele dvs.
Încărcați modificările pe GitHub
Împinge schimbările tale cu comanda git push:
git push -u origin numele-ramurii-tale
înlocuind numele-ramurii-tale cu numele ramurii pe care ați creat-o anterior.
Dacă întâmpinați erori în timpul încărcării, apăsați aici:
-
Eroare de autentificare
remote: Suportul pentru autentificarea prin parolă a fost eliminat la 13 august 2021. Vă rugăm să utilizați un token de acces personal în schimb. remote: Vă rugăm să consultați https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ pentru mai multe informații. fatal: Autentificare eșuată pentru 'https://github.com//first-contributions.git/'
înlocuind numele-tau cu numele dvs. de utilizator GitHub.
Mergeți la tutorialul GitHub pentru a genera și configura o cheie SSH pentru contul dvs.
Trimiteți modificările pentru a fi revizuite
Dacă mergeți în depozitul dvs. de pe GitHub, veți vedea un buton Compară și cereți trageri. Faceți clic pe acest buton.
Acum trimiteți cererea de tragere.
În curând, voi integra toate modificările dvs. în ramura principală a acestui proiect. Veți primi o notificare prin e-mail odată ce modificările vor fi integrate.
Unde să mergeți de aici?
Felicitări! Ați finalizat fluxul standard fork -> clone -> edit -> pull request pe care îl veți întâlni adesea ca contributor!
Sărbătoriți-vă contribuția și partajați-o cu prietenii și urmăritorii dvs., accesând aplicația web.
Puteți să vă alăturați echipei noastre Slack dacă aveți nevoie de ajutor sau aveți întrebări. Alăturați-vă echipei Slack.
Acum să vă începem cu contribuția la alte proiecte. Am compilat o listă de proiecte cu probleme ușoare cu care puteți începe. Verificați lista de proiecte din aplicația web.
Materiale suplimentare
Tutoriale Folosind Alte Unelte (GUI)
| GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |
Acest proiect este susținut de:
