Wnieś swój wkład przez Github

Wymagania wstępne

Aby móc wnosić wkład za pośrednictwem żądań ściągnięcia, istnieje kilka warunków wstępnych:

Wiedzieć, jak używać minimum Git
Mieć konto Github
Miej rozwidlenie projektu, w którym chcesz się przyczynić

Zanim przejdziemy do szczegółów, konieczne będzie zwrócenie uwagi na słownictwo. Oto mały słowniczek słów, których stale używamy w Git/Github:

repo: Skrót od „Repozytorium”. Używamy tego słowa do oznaczenia zestawu plików wersjonowanych za pomocą Git.
oddział: To jest oddział w projekcie Git. Gałęzie umożliwiają utworzenie równoległej wersji kodu w pewnym momencie historii.
master: Wyznacza główną gałąź repozytorium.
origin: Określa zdalne repozytorium. Na przykład hostowane na Github.
pull request: Jest to operacja, która pozwala zaproponować modyfikację kodu do projektu na Githubie.
fork: To jest repozytorium, które jest kopią innego repozytorium. Dzięki temu możesz zacząć od istniejącego projektu, aby go zmodyfikować, ulepszyć, poprawić lub zrobić z nim coś innego.
upstream: W przypadku rozwidlenia oznacza repozytorium, z którego pochodzi rozwidlenie.
fetch: Jest to operacja polegająca na lokalnym pobraniu danych ze zdalnego.
push: Jest to operacja umożliwiająca wysłanie lokalnych danych do pilota.

Konfiguracja

Widelec

Pierwszą rzeczą do zrobienia jest przejście do Github, aby utworzyć fork projektu, do którego chcesz się przyczynić.

Na przykład, aby współtworzyć klienta Leek Wars, przejdź tutaj: Klient Leek Wars

Następnie kliknij przycisk „widelec” w prawym górnym rogu.

„Rozwidlając” projekt, Github utworzy nowe repozytorium na Twoim koncie. Będzie to kopia oryginalnego projektu.

Następnie uzyskaj adres swojego repozytorium github, za pomocą adresu URL lub klikając zielony przycisk „Klonuj lub pobierz”.

Przejdź do lokalizacji, w której chcesz umieścić swoje lokalne repo i użyj polecenia: git clone \ Nie zapomnij zastąpić „\”.

Więc. Utworzyłeś fork projektu i pobrałeś go lokalnie na swoim komputerze. Ale jest jeszcze jedna rzecz, którą należy zrobić, aby móc dalej bez obaw korzystać z niego w przyszłości.

Pod prąd

Następnie musisz skonfigurować upstream, co pozwoli ci zaktualizować repozytorium z projektu.

Polecenie git remote -v pozwala wyświetlić listę skonfigurowanych adresów zdalnych.

pochodzenie https://github.com/YOUR_USERNAME/YOUR_FORK.git (pobierz) pochodzenie https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

Na razie powinieneś zobaczyć dwa adresy skonfigurowane jako Origin. Jeden w pobieraniu, gdy chcesz repatriować nowe funkcje ze swojego zdalnego, repozytorium hostowanego na Githubie. A drugi w push, który z kolei umożliwia wysyłanie lokalnych wiadomości do zdalnego repo.

Do tego dodamy upstream. Aby to zrobić, uzyskaj adres projektu, który właśnie rozwidliłeś. Zawsze za pomocą adresu URL lub przycisku „Klonuj lub pobierz”.

Polecenie dodania upstream to: git remote add upstream \

Jeśli ponownie uruchomisz komendę git remote -v, powinieneś zobaczyć teraz cztery wpisy. Dwa dla początku i dwa dla górnego. Każdy powielony na pobranie i pchnięcie.

pochodzenie https://github.com/YOUR_USERNAME/YOUR_FORK.git (pobierz) pochodzenie https://github.com/YOUR_USERNAME/YOUR_FORK.git (push) upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (pobieranie) upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

Jesteś gotowy do wniesienia wkładu już teraz!

Bądź na bieżąco

(Krok nie jest konieczny, jeśli po prostu widelec.)

Istnieje duże prawdopodobieństwo, że projekt, w który się angażujesz, nie jest osadzony w kamieniu. Ludzie, którzy się nim opiekują, sprawią, że będzie ewoluował. Inne wkłady będą potencjalnie akceptowane.

Twoje repo może zatem szybko stać się przestarzałe. I to może być problem.

Jeśli oryginalnie plik zawierał literę „A”, a Ty chcesz zgłosić wkład w zamianę tej litery „A” na „B”. W międzyczasie może ktoś inny dokona zamiany z tego "A" na "C".

A kiedy zaproponujesz swoją modyfikację, nastąpi konflikt. Nie można zmienić „A” na „B”, ponieważ „A” nie występuje już w pliku.

Krótko mówiąc, ważne jest, aby aktualizować repo, aby uniknąć przykrych niespodzianek.

Nie martw się, teraz, gdy skonfigurowałeś upstream, to będzie bułka z masłem!

Pierwszą rzeczą do zrobienia jest zdobycie nowego m