Kurzanleitung zur Verwendung von Github

Dieses Tutorial ist eine Kurzanleitung zur Installation und Verwendung von GitHub. Hier erfahren Sie unter anderem, wie Sie ein lokales Repository erstellen, dieses lokale Repository mit dem Remote-Github-Repository verbinden (wo jeder es sehen kann), wie Sie Änderungen festschreiben und schließlich den gesamten lokalen Repository-Inhalt auf GitHub übertragen. .

Bevor Sie beginnen, ist es wichtig zu beachten, dass dieses Tutorial ein grundlegendes Verständnis der in Git verwendeten Begriffe voraussetzt: Push, Pull, Commit, Repository usw. Es erfordert auch eine vorherige Registrierung bei GitHub.

Github Installation

Zu Debian / Ubuntu und Derivaten:

sudo apt-get installieren git

En Fedora und Derivate:

sudo yum installiere git

En Bogen und Derivate:

sudo pacman -s git

Github Ersteinrichtung

Nach erfolgreicher Installation besteht der nächste Schritt darin, die Konfigurationsdetails des GitHub-Benutzers zu konfigurieren. Verwenden Sie dazu die folgenden Befehle und ersetzen Sie "Benutzername" durch Ihren GitHub-Benutzernamen und "email_id" durch die E-Mail-Adresse, die zum Erstellen des GitHub-Kontos verwendet wurde.

git config --global user.name "Benutzername" git config --global user.email "email_id"

Erstellen Sie ein lokales Repository

Als erstes erstellen Sie einen Ordner auf Ihrem Computer, der als lokales Repository dient. Führen Sie dazu einfach den folgenden Befehl aus:

Git Init Mytest

Dieser Befehl erstellt den MyTest-Ordner. Im Unterordner .init wird MyTest wiederum als lokales Git-Repository erkannt.

Wenn das Repository erfolgreich erstellt wurde, wird eine Zeile ähnlich der folgenden angezeigt:

Initialisiertes leeres Git-Repository in /home/tu_usuario/Mytest/.git/

Dann müssen Sie zum Ordner MyTest gehen:

CD Mytest

Erstellen Sie eine README-Datei, um das Repository zu beschreiben

Die README-Datei wird im Allgemeinen verwendet, um zu beschreiben, was das Repository enthält oder worum es im Projekt geht. Um eine zu erstellen, führen Sie einfach Folgendes aus:

gedit README

Vergessen Sie nicht, Ihre Änderungen zu speichern, nachdem Sie die Repository-Beschreibung eingegeben haben.

Hinzufügen der Repository-Dateien zu einem Index

Dies ist ein wichtiger Schritt. Bevor Sie Ihre Änderungen auf Github oder einen anderen Git-kompatiblen Server hochladen können, müssen Sie alle im lokalen Repository enthaltenen Dateien indizieren. Dieser Index enthält die neuen Dateien sowie Änderungen an den vorhandenen Dateien im lokalen Repository.

In unserem Fall enthält unser lokales Repository bereits eine neue Datei: die README. Daher werden wir eine weitere Datei mit einem einfachen C-Programm erstellen, die wir example.c nennen werden. Sein Inhalt wird sein:

#include int main () {printf ("Hallo Welt"); return 0; }}

Jetzt haben wir 2 Dateien in unserem lokalen Repository: README und example.c.

Der nächste Schritt besteht darin, diese Dateien zum Index hinzuzufügen:

git add README git add smaple.c

Mit dem Befehl "git add" können dem Index beliebig viele Dateien und Ordner hinzugefügt werden. Um alle Änderungen hinzuzufügen, ohne den Namen der Dateien anzugeben, ist es möglich, "git add" auszuführen. (mit einem Punkt am Ende).

Speichern Sie die am Index vorgenommenen Änderungen

Sobald alle Dateien hinzugefügt wurden, können Sie diese Änderungen aufzeichnen, indem Sie das tun, was im Jargon als "Commit" bezeichnet wird. Dies bedeutet, dass das Hinzufügen oder Ändern von Dateien abgeschlossen wurde und die Änderungen in das Remote-Github-Repository hochgeladen werden können. Dazu müssen Sie den folgenden Befehl ausführen:

git commit -m "Nachricht"

"Nachricht" kann eine beliebige Nachricht sein, die die fraglichen Änderungen kurz beschreibt, z. B. "Ich habe solche Funktionen hinzugefügt" oder "Ich habe solche Dinge korrigiert" und so weiter.

Erstellen Sie ein Repository auf GitHub

Der Repository-Name muss mit dem Repository auf dem lokalen System übereinstimmen. In diesem Fall ist es "MyTest". Dazu müssen Sie sich zunächst anmelden Github. Dann müssen Sie auf das Pluszeichen (+) in der oberen rechten Ecke der Seite klicken und die Option "Neues Repository erstellen" auswählen. Zum Schluss müssen Sie die Daten eingeben und auf die Schaltfläche "Repository erstellen" klicken.

Sobald dies erledigt ist, wird das Repository erstellt und es ist möglich, den Inhalt des lokalen Repositorys in das GitHub-Repository hochzuladen. Um eine Verbindung zum Remote-Repository auf GitHub herzustellen, müssen Sie den folgenden Befehl ausführen:

git remote Herkunft hinzufügen https://github.com/user_name/Mytest.git

Push-Dateien aus dem lokalen Repository in das GitHub-Repository

Der letzte Schritt besteht darin, den Inhalt des lokalen Repositorys mit dem folgenden Befehl in das Remote-Repository zu übertragen:

git push Ursprung Master

Es bleiben nur die Anmeldeinformationen (Benutzername und Passwort) einzugeben.

Dadurch wird der gesamte Inhalt des MyTest-Ordners (lokales Repository) in GitHub (externes Repository) hochgeladen. Für nachfolgende Projekte müssen Sie diese Schritte nicht mehr von Grund auf ausführen. Stattdessen können Sie direkt mit Schritt 3 beginnen. Vergessen Sie nicht, dass die Änderungen auf der Github-Website verfügbar sein werden.

Zweig erstellen

Wenn Entwickler Fehler beheben oder neue Funktionen hinzufügen möchten, erstellen sie häufig einen Zweig oder eine Kopie des Codes, damit sie separat festschreiben können, ohne das ursprüngliche Projekt zu beeinträchtigen. Wenn sie fertig sind, können sie diesen Zweig wieder mit dem Hauptzweig (Master) zusammenführen.

Um einen neuen Zweig zu erstellen, gibt es zwei Möglichkeiten:

Lange Option:

git branch mirama # Erstelle einen neuen Zweig namens mirama git checkout mirama - wechsle zur Verwendung des mirama-Zweigs.

Kurze Option:

git checkout -b mirama - erstelle und wechsle zur Verwendung des mirama-Zweigs

Sobald die Änderungen vorgenommen wurden, fügen Sie sie dem Zweigindex hinzu und führen Sie das entsprechende Commit durch:

git hinzufügen. git commit -m "Änderungen an Mirama"

Dann müssen Sie zum Hauptzweig zurückkehren und die in mirama vorgenommenen Änderungen vornehmen:

Git Checkout Master Git Merge Mirama

Schließlich müssen Sie mirama löschen (da die Änderungen in master übernommen wurden):

Git Branch -d Mirama

Und lade den Master auf Github hoch:

git push Ursprung Master

Erstellen eines abgeleiteten Git-Repositorys (Fork)

Dank Git und der Existenz großer öffentlicher Repository-Bibliotheken wie Github ist es meistens nicht erforderlich, unser Projekt von Grund auf neu zu programmieren. In diesen Fällen ist es möglich, diesen Basiscode zum Erstellen eines neuen Projekts zu verwenden.

Dazu müssen Sie zunächst einen Zweig eines vorhandenen Repositorys aufteilen, dh ein Projekt, das basierend auf dem Code des ursprünglichen Projekts daraus abgeleitet wurde. Auf Github wird dies erreicht, indem Sie auf die entsprechende Schaltfläche klicken (siehe Abbildung unten).

Dann müssen wir das Repository dieses neuen Projekts auf unseren Computer klonen. Als Beispiel können wir mein Ankifox-Repository verwenden, eine Erweiterung für Firefox, mit der Wörter hinzugefügt werden können Anki, das auf Github verfügbar ist:

Git-Klon https://github.com/usemoslinux/Ankifox.git

Vergessen Sie nicht, https://github.com/usemoslinux/Ankifox.git durch die Ihrem Projekt entsprechende URL zu ersetzen. Das Abrufen dieser Adresse ist sehr einfach, wie im Bild unten dargestellt.

Dieser Befehl erstellt ein Verzeichnis mit dem Namen «Ankifox», initialisiert das darin enthaltene .git-Verzeichnis und lädt alle Daten aus diesem Repository herunter, um mit der neuesten Version zu arbeiten.