Krótki przewodnik po korzystaniu z Github

Ten samouczek jest krótkim przewodnikiem po instalowaniu i korzystaniu z usługi GitHub. Oto jak utworzyć lokalne repozytorium, jak połączyć to lokalne repozytorium ze zdalnym repozytorium Github (gdzie każdy może je zobaczyć), jak zatwierdzać zmiany, a na koniec, jak wypchnąć całą zawartość lokalnego repozytorium na GitHub, wśród innych typowych zadań.

Zanim zaczniemy, ważne jest, aby pamiętać, że ten samouczek zakłada podstawowe zrozumienie terminów używanych w Git: push, pull, commit, repository itp. Wymaga również wcześniejszej rejestracji pod adresem GitHub.

Instalacja Github

Na Debianie / Ubuntu i pochodnych:

sudo apt-get install git

En Fedora i pochodne:

sudo yum zainstaluj git

En łuk i pochodne:

pot pacman -S git

Wstępna konfiguracja Githuba

Po pomyślnym zakończeniu instalacji następnym krokiem jest skonfigurowanie szczegółów konfiguracji użytkownika GitHub. Aby to zrobić, użyj następujących poleceń, zastępując „nazwę użytkownika” swoją nazwą użytkownika GitHub, a „email_id” adresem e-mail użytym do utworzenia konta GitHub.

git config --global nazwa.użytkownika "nazwa użytkownika" git config --global user.email "email_id"

Utwórz lokalne repozytorium

Pierwszą rzeczą jest utworzenie folderu na komputerze, który będzie służył jako lokalne repozytorium. Aby to zrobić, po prostu uruchom następujące polecenie:

git init Mój test

To polecenie tworzy folder MyTest. Z kolei podfolder .init sprawia, że ​​MyTest jest rozpoznawany jako lokalne repozytorium Git.

Jeśli repozytorium zostało pomyślnie utworzone, pojawi się wiersz podobny do poniższego:

Zainicjowano puste repozytorium Git w /home/tu_usuario/Mytest/.git/

Następnie musisz przejść do folderu MyTest:

Mój test płyty

Utwórz plik README, aby opisać repozytorium

Plik README jest zwykle używany do opisania, co zawiera repozytorium lub o czym jest projekt. Aby je utworzyć, po prostu uruchom:

edytuj plik README

Po wprowadzeniu opisu repozytorium nie zapomnij zapisać zmian.

Dodawanie plików repozytorium do indeksu

To ważny krok. Zanim będziesz mógł przesłać swoje zmiany na Github lub inny serwer kompatybilny z Git, musisz zindeksować wszystkie pliki zawarte w lokalnym repozytorium. Ten indeks będzie zawierał nowe pliki, a także zmiany w istniejących plikach w lokalnym repozytorium.

W naszym przypadku nasze lokalne repozytorium zawiera już nowy plik: README. Dlatego utworzymy kolejny plik za pomocą prostego programu w języku C, który nazwiemy przykładem.c. Jego zawartość będzie:

#include int main () {printf ("witaj świecie"); return 0; }

Więc teraz mamy 2 pliki w naszym lokalnym repozytorium: README i example.c.

Następnym krokiem jest dodanie tych plików do indeksu:

git add README git add smaple.c

Polecenie „git add” może służyć do dodawania dowolnej liczby plików i folderów do indeksu. Aby dodać wszystkie zmiany, bez podawania nazwy plików, można wykonać polecenie „git add”. (z kropką na końcu).

Zapisz zmiany wprowadzone w indeksie

Po dodaniu wszystkich plików można zostawić zapis tych zmian, wykonując to, co w żargonie nazywa się „zatwierdzeniem”. Oznacza to, że dodawanie lub modyfikowanie plików zostało zakończone, a zmiany można przesłać do zdalnego repozytorium Github. Aby to zrobić, musisz wykonać następujące polecenie:

git commit -m "wiadomość"

„Wiadomość” może być dowolną wiadomością, która w skrócie opisuje zmiany, o których mowa, na przykład: „Dodałem taką funkcjonalność” lub „Poprawiłem coś takiego” itd.

Utwórz repozytorium na GitHub

Nazwa repozytorium musi być taka sama, jak repozytorium w systemie lokalnym. W tym przypadku będzie to „MójTest”. Aby to zrobić, musisz najpierw zalogować się do Github. Następnie kliknij znak plus (+) w prawym górnym rogu strony i wybierz opcję „utwórz nowe repozytorium”. Na koniec musisz wypełnić dane i kliknąć przycisk „utwórz repozytorium”.

Gdy to zrobisz, repozytorium zostanie utworzone i będzie można przesłać zawartość repozytorium lokalnego do repozytorium GitHub. Aby połączyć się ze zdalnym repozytorium na GitHub, musisz uruchomić polecenie:

git remote dodaj pochodzenie https://github.com/user_name/Mytest.git

Wypychaj pliki z lokalnego repozytorium do repozytorium GitHub

Ostatnim krokiem jest wypchnięcie zawartości repozytorium lokalnego do repozytorium zdalnego za pomocą polecenia:

git push origin master

Pozostaje tylko wprowadzić dane logowania (nazwę użytkownika i hasło).

Spowoduje to przesłanie całej zawartości folderu MyTest (repozytorium lokalnego) do GitHub (repozytorium zewnętrzne). W przypadku kolejnych projektów nie musisz już wykonywać tych kroków od zera. Zamiast tego możesz rozpocząć bezpośrednio od kroku 3. Na koniec nie zapominaj, że zmiany będą dostępne na stronie Github.

Tworzenie oddziału

Gdy programiści chcą naprawić błędy lub dodać nowe funkcje, często tworzą gałąź lub kopię kodu, aby mogli zatwierdzać oddzielnie, bez wpływu na oryginalny projekt. Następnie, kiedy skończą, mogą scalić tę gałąź z powrotem w gałąź główną (master).

Aby utworzyć nowy oddział, istnieją dwie opcje:

Opcja długa:

git branch mirama # utwórz nową gałąź o nazwie mirama git checkout mirama - przełącz się na używanie gałęzi mirama.

Krótka opcja:

git checkout -b mirama - utwórz i przełącz się na używanie gałęzi mirama

Po wprowadzeniu zmian dodaj je do indeksu gałęzi i wykonaj odpowiednie zatwierdzenie:

git add. git commit -m "zmiany w mirama"

Następnie musisz wrócić do głównej gałęzi i wprowadzić zmiany wprowadzone w miramie:

git checkout master git merge mirama

Na koniec musisz usunąć mirama (ponieważ zmiany zostały wprowadzone do mastera):

git gałąź -d mirama

I prześlij mastera na Github:

git push origin master

Tworzenie pochodnego repozytorium Git (fork)

Dzięki Gitowi i istnieniu dużych bibliotek repozytoriów publicznych, takich jak Github, w większości przypadków nie jest konieczne programowanie naszego projektu od zera. W takich przypadkach można użyć tego kodu podstawowego do utworzenia nowego projektu.

Aby to zrobić, pierwszą rzeczą do zrobienia jest rozwidlenie istniejącego repozytorium, to znaczy projektu pochodnego, który przyjmuje kod oryginalnego projektu jako podstawę. Na Github można to osiągnąć, klikając odpowiedni przycisk, jak widać na poniższym zrzucie ekranu.

Następnie musimy sklonować repozytorium tego nowego projektu na naszym komputerze. Jako przykład możemy użyć mojego repozytorium Ankifox, rozszerzenia dla przeglądarki Firefox, które umożliwia dodawanie słów do Anki, który jest dostępny na Github:

klon git https://github.com/usemoslinux/Ankifox.git

Nie zapomnij zamienić adresu https://github.com/usemoslinux/Ankifox.git na adres URL odpowiadający Twojemu projektowi. Uzyskanie tego adresu jest bardzo łatwe, jak widać na poniższym obrazku.

To polecenie utworzy katalog o nazwie «Ankifox», zainicjuje w nim katalog .git i pobierze wszystkie dane z tego repozytorium, aby pracować z najnowszą wersją.