Ein Repository forken

Üblicherweise werden Forks genutzt, um Änderungen für ein Projekt eines anderes Benutzers vorzuschlagen oder ein Projekt eines anderen Benutzers als Ausgangspunkt für eigene Ideen zu verwenden.

Änderungen für ein Projekt eines anderen Benutzers vorschlagen

Du kannst Forks beispielsweise benutzen, um Änderungen im Zusammenhang mit der Behebung eines Fehlers vorzuschlagen. Anstatt einen Issue für einen Bug zu erstellen, kannst Du:

• das Repository forken,
• den Fehler beheben,
• einen Pull Request an den Projektinhaber senden.

Ein Projekt eines anderen Benutzers als Ausgangspunkt für eigene Ideen verwenden

Open-Source-Software basiert auf der Idee, dass wir durch gemeinsamen Code bessere, zuverlässigere Software erstellen können. Weitere Informationen findest Du in „Über die Open-Source-Initiative“ auf der Open-Source-Initiative-Website.

Wenn Du ein öffentliches Repository von einem Fork eines Projekts eines anderen Benutzers erstellst, musst Du unbedingt eine Lizenzdatei hinzufügen, die bestimmt, wie Dein Projekt für andere Personen freigegeben wird. Weitere Informationen findest Du unter „Wähle eine Open-Source-Lizenz“ auf der choosealicense-Website.

Für weitere Informationen zu Open-Source, insbesondere zum Erstellen und Vergrößern eines Open-Source-Projekts, haben wir Open-Source Leitfäden erstellt, die Dir durch die Empfehlung von Best Practices für das Erstellen und Unterhalten von Repositorys helfen, eine gesunde Open-Source-Community zu pflegen. Du kannst auch einen kostenlosen GitHub Learning Lab Kurs zur Pflege von Open-Source-Communitys absolvieren.

Ein Beispiel-Repository forken

Das Forken eines Repositorys ist ein einfacher Vorgang, bestehend aus zwei Schritten. Wir haben ein Repository erstellt, mit dem Du das Forken üben kannst.

1. Navigiere auf Ihre GitHub Enterprise Server-Instanz zum Repository octocat/Spoon-Knife.
2. Klicke in der oberen rechte Ecke der Seite auf Fork.
   

Deinen Fork regelmäßig synchronisieren

Du forkst vielleicht ein Projekt, um Änderungen an das vorgelagerte - oder originale - Repository vorzuschlagen. In diesem Fall ist es ratsam, Deinen Fork regelmäßig mit dem vorgelagerten Repository zu synchronisieren. Zu diesem Zweck musst Du Git in der Befehlszeile verwenden. Das Festlegen des vorgelagerten Repositorys kannst Du mit demselben Repository octocat/Spoon-Knife üben, das Du gerade geforkt hast.

Schritt 1: Git einrichten

Wenn Du es noch nicht getan hast, musst Du zunächst Git einrichten. Denke auch daran, Authentifizierungen zu Ihre GitHub Enterprise Server-Instanz über Git einzurichten.

Schritt 2: einen lokalen Klon Deines Forks erstellen

Momentan besitzt Du einen Fork des Repositorys „Spoon-Knife“, aber Du hast die Dateien dieses Repositorys nicht auf Deinem Computer. Deswegen erstellen wir nun einen Klon Deines Forks lokal auf Deinem Computer.

1. Navigiere auf GitHub Enterprise zu Deinem Fork des Repositorys „Spoon-Knife“.

2. Klicke unter dem Repository-Namen auf Clone or download (Klonen oder herunterladen).

   

3. Um ein Repository mittels HTTPS zu klonen, klicke unter „Clone with HTTPS" (mit HTTPS klonen) auf . To clone the repository using an SSH key click Use SSH, then click .

   

4. Öffne TerminalTerminalGit Bash.

5. Ändere das aktuelle Arbeitsverzeichnis zum Speicherort, in dem Du das geklonte Verzeichnis haben willst.

6. Gib git clone ein, und füge dann die zuvor kopierte URL ein. Der Befehl sieht wie folgt aus, wobei YOUR-USERNAME durch Deinen GitHub Enterprise-Benutzernamen ersetzt wird:

   $ git clone https://Hostname/YOUR-USERNAME/Spoon-Knife

7. Drücke die Eingabetaste. Der lokale Klon wird erstellt.

   $ git clone https://Hostname/YOUR-USERNAME/Spoon-Knife
   > Cloning into `Spoon-Knife`...
   > remote: Counting objects: 10, done.
   > remote: Compressing objects: 100% (8/8), done.
   > remove: Total 10 (delta 1), reused 10 (delta 1)
   > Unpacking objects: 100% (10/10), done.

Jetzt hast Du eine lokale Kopie Deiner Fork des Spoon-Knife-Repositorys.

Schritt 3: Git für das Synchronisieren Deines Forks mit dem Original-Repository „Spoon-Knife“ konfigurieren

Wenn Du ein Projekt forkst, um Änderungen für das Original-Repository vorzuschlagen, kannst Du Git so konfigurieren, dass Änderungen am vorgelagerten (originalen) Repository in den lokalen Klon Deiner Fork abgerufen werden.

1. Navigiere auf GitHub Enterprise zum Repository octocat/Spoon-Knife.

2. Klicke unter dem Repository-Namen auf Clone or download (Klonen oder herunterladen).

   

3. Um ein Repository mittels HTTPS zu klonen, klicke unter „Clone with HTTPS" (mit HTTPS klonen) auf . To clone the repository using an SSH key click Use SSH, then click .

   

4. Öffne TerminalTerminalGit Bash.

5. Wechsle das Verzeichnis zum Speicherort des Forks, den Du bei Schritt 2: einen lokalen Klon Deines Forks erstellen geklont hast.

   • Um in Dein Home-Verzeichnis zu wechseln, gib einfach cd ohne zusätzlichen Text ein.
   • Um die Dateien und Ordner im aktuellen Verzeichnis anzuzeigen, gib ls ein.
   • Um in eines der aufgelisteten Verzeichnisse zu wechseln, gib cd aufgeführtes_verzeichnis ein.
   • Um ein Verzeichnis nach oben zu wechseln, gib cd .. ein.

6. Gib git remote -v ein, und drück die Eingabetaste. Daraufhin siehst Du das aktuell konfigurierte Remote-Repository für Deinen Fork.

   $ git remote -v
   > origin  https://Hostname/YOUR_USERNAME/YOUR_FORK.git (fetch)
   > origin  https://Hostname/YOUR_USERNAME/YOUR_FORK.git (push)

7. Gib git remote add upstream ein. Füge dann die URL ein, die Du bei Schritt 2 kopiert hast, und drücke die Eingabetaste. Dies sieht wie folgt aus:

   $ git remote add upstream https://Hostname/octocat/Spoon-Knife.git

8. Um das neue vorgelagerte Repository zu überprüfen, das Du für Deinen Fork angegeben hast, gib erneut git remote -v ein. Nun sollte die URL Deiner Fork als origin und die URL des Original-Repositorys als upstream aufgeführt sein.

   $ git remote -v
   > origin    https://Hostname/YOUR_USERNAME/YOUR_FORK.git (fetch)
   > origin    https://Hostname/YOUR_USERNAME/YOUR_FORK.git (push)
   > upstream  https://Hostname/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (fetch)
   > upstream  https://Hostname/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

Nun kannst Du Deinen Fork mit wenigen Git-Befehlen regelmäßig mit dem vorgelagerten Repository synchronisieren. Weitere Informationen findest Du unter „Fork synchronisieren.“

Nächste Schritte:

Du kannst nun jede Änderung am Fork vornehmen, einschließlich:

• Branches erstellen: Mit Branches kannst Du ohne Risiko für das Hauptprojekt neue Funktionen entwickeln oder Ideen testen.
• Pull Requests öffnen: Wenn Du einen Beitrag zum Original-Repository leisten möchtest, kannst Du einen Pull Request an den Original-Autor senden und ihn dazu auffordern, Deinen Fork in sein Repository abzurufen.

Ein anderes Repository zum Forken finden

Forke ein Repository, um an einem Projekt mitzuarbeiten. Du kannst jedes öffentliche Repository zu Deinem Benutzerkonto oder zu jeder Organisation forken, in der Du die Berechtigung zum Erstellen von Repositorys hast. Weitere Informationen findest Du unter „Berechtigungsebenen für eine Organisation".

Du kannst jedes private Repository, auf das Du Zugriff hast, zu Deinem Benutzerkonto oder zu jeder Organisation auf GitHub Team oder GitHub Enterprise forken, in denen Du die Berechtigung zum Erstellen von Repositorys hast. Du kannst ein privates Repository nicht an eine Organisation forken, die GitHub Free verwendet.

Geschafft!

Du hast jetzt ein Repository geforkt, das Klonen Deines Forks geübt und ein vorgelagertes Repository konfiguriert. Was möchtest Du als Nächstes tun?

• „Git einrichten“
• „Repository erstellen“
• „Soziale Interaktion“
• Verbinde Dich mit Menschen auf der ganzen Welt in GitHub Community Support