Tragen Sie über Github bei

Über Github beitragen

Voraussetzungen

Um über Pull-Requests beitragen zu können, gibt es mehrere Voraussetzungen:

• Wissen, wie man ein Minimum an Git verwendet
• Haben Sie ein Github-Konto
• Haben Sie einen Fork des Projekts, zu dem Sie beitragen möchten

Bevor wir ins Detail gehen, ist es notwendig, einen kleinen Punkt zum Vokabular zu machen. Hier ist ein kleines Glossar von Wörtern, die wir ständig mit Git/Github verwenden:

• repo: Abkürzung für „Repository“. Wir verwenden dieses Wort, um eine Reihe von Dateien zu bezeichnen, die mit Git versioniert sind.
• branch: Dies ist ein Branch in einem Git-Projekt. Verzweigungen ermöglichen es Ihnen, zu einem bestimmten Zeitpunkt im Verlauf eine parallele Version des Codes zu erstellen.
• master: Bezeichnet den Hauptzweig des Repos.
• Herkunft: Bezeichnet das entfernte Repo. Zum Beispiel auf Github gehostet.
• Pull Request: Dies ist die Operation, mit der Sie eine Codeänderung für ein Projekt auf Github vorschlagen können.
• Fork: Dies ist ein Repo, das eine Kopie eines anderen Repos ist. Dadurch können Sie von einem bestehenden Projekt ausgehen, um es zu ändern, zu verbessern, zu korrigieren oder etwas anderes damit zu machen.
• Upstream: Bezeichnet im Falle eines Forks das Repo, von dem der Fork stammt.
• fetch: Dies ist die Operation, die darin besteht, Daten von der Gegenstelle lokal abzurufen.
• push: Dies ist die Operation, mit der lokale Daten an die Gegenstelle gesendet werden können.

Konfiguration

Gabelung

Das erste, was Sie tun müssen, ist, zu Github zu gehen, um einen Fork des Projekts zu erstellen, zu dem Sie beitragen möchten.

Um zum Beispiel zum Leek Wars-Client beizutragen, gehen Sie hier: Leek Wars Client

Klicken Sie dann einfach oben rechts auf die Schaltfläche "Fork".

Durch das „Forken“ des Projekts erstellt Github ein neues Repo auf Ihrem Konto. Dies wird eine Kopie des ursprünglichen Projekts sein.

Rufen Sie dann die Adresse Ihres Github-Repositorys über die URL-Adresse ab oder klicken Sie auf die grüne Schaltfläche „Klonen oder herunterladen“.

Gehen Sie zu dem Ort, an dem Sie Ihr lokales Repo platzieren möchten, und verwenden Sie den Befehl: git-Klon \ Vergessen Sie nicht, "\" zu ersetzen.

So. Sie haben einen Fork des Projekts erstellt und ihn lokal auf Ihrem Computer abgerufen. Aber es gibt noch etwas zu tun, um es auch in Zukunft unbesorgt nutzen zu können.

Upstream

Sie müssen dann den Upstream konfigurieren, der es Ihnen ermöglicht, Ihr Repo vom Projekt-Repo aus zu aktualisieren.

Mit dem Befehl git remote -v können Sie die konfigurierten Remote-Adressen auflisten.

Herkunft https://github.com/YOUR_USERNAME/YOUR_FORK.git (abrufen) Ursprung https://github.com/YOUR_USERNAME/YOUR_FORK.git (Push)

Im Moment sollten Sie zwei Adressen sehen, die als Ursprung konfiguriert sind. Eine in fetch, wenn Sie neue Funktionen von Ihrer Remote, Ihrem auf Github gehosteten Repo, zurückholen möchten. Und die andere in Push, was es Ihnen umgekehrt ermöglicht, Ihre lokalen Nachrichten an das entfernte Repo zu senden.

Dazu fügen wir den Upstream hinzu. Rufen Sie dazu die Adresse des Projekts ab, das Sie gerade gegabelt haben. Immer über die URL oder die Schaltfläche "Klonen oder herunterladen".

Der Befehl zum Hinzufügen des Upstream lautet: git remote add upstream \

Wenn Sie den Befehl git remote -v erneut ausführen, sollten Sie jetzt vier Einträge sehen. Zwei für den Ursprung und zwei für den Upstream. Jeder dupliziert in einen fetch und einen push.

Herkunft https://github.com/YOUR_USERNAME/YOUR_FORK.git (abrufen) Herkunft https://github.com/YOUR_USERNAME/YOUR_FORK.git (Push) Upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (abrufen) Upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (Push)

Sie sind jetzt bereit, einen Beitrag zu leisten!

Auf dem Laufenden bleiben

(Schritt nicht erforderlich, wenn Sie nur gabeln.)

Die Chancen stehen gut, dass das Projekt, zu dem Sie beitragen, nicht in Stein gemeißelt ist. Die Menschen, die sich darum kümmern, werden es weiterentwickeln. Andere Beiträge werden möglicherweise akzeptiert.

Ihr Repo kann daher schnell veraltet sein. Und das könnte ein Problem sein.

Wenn ursprünglich eine Datei „A“ enthielt, und Sie einen Beitrag einreichen möchten, ändern Sie dieses „A“ in „B“. In der Zwischenzeit hat vielleicht jemand anderes von diesem "A" auf "C" geändert.

Und wenn Sie Ihre Änderung vorschlagen, wird es einen Konflikt geben. "A" kann nicht in "B" geändert werden, da "A" nicht mehr in der Datei vorhanden ist.

Kurz gesagt, es ist wichtig, das Repo auf dem neuesten Stand zu halten, um unangenehme Überraschungen zu vermeiden.

Keine Sorge, jetzt, da Sie den Upstream konfiguriert haben, wird es ein Kinderspiel!

Das erste, was zu tun ist, ist, den neuen m zu bekommen