Schnellstart für Repositorys

Erfahren Sie, wie Sie ein neues Repository erstellen und ihre erste Änderung in 5 Minuten committen.

Tool navigation

In diesem Artikel

Erstellen eines Repositorys

GitHub-Repositorys speichern verschiedene Arten von Projekten. In diesem Leitfaden erstellen Sie ein Repository und committen Ihre erste Änderung.

  1. Wähle in der rechten oberen Ecke einer beliebigen Seite , und klicke dann auf Neues Repository.

    Screenshot eines GitHub-Dropdownmenüs mit Optionen zum Erstellen neuer Elemente. Das Menüelement „Neues Repository“ ist in dunklem Orange eingerahmt.

  2. Gib einen kurzen, einprägsamen Namen für das Repository ein. Beispiel: „hello world“.

    Screenshot des ersten Schritts beim Erstellen eines GitHub-Repositorys. Das Feld „Repositoryname“ enthält den Text „hello-world“ und ist in dunklem Orange eingerahmt.

  3. Füge optional eine Beschreibung deines Repositorys hinzu. Beispiel: „Mein erstes Repository auf GitHub“.

  4. Wähle eine Sichtbarkeitsoption für das Repository aus. Weitere Informationen findest du unter Informationen zu Repositorys.

  5. Aktivieren Sie das Kontrollkästchen Initialize this repository with a README (Dieses Repository mit einer README-Datei initialisieren).

  6. Klicke auf Repository erstellen.

Herzlichen Glückwunsch! Du hast erfolgreich dein erstes Repository erstellt und mit einer README-Datei initialisiert.

Note

Weitere Informationen zur GitHub CLI findest du unter Informationen zur GitHub CLI.

  1. Navigiere in der Befehlszeile zu dem Verzeichnis, in dem du einen lokalen Klon deines neuen Projekts erstellen möchtest.
  2. Verwende zum Erstellen eines Repositorys für dein Projekt den Unterbefehl gh repo create. Wenn du dazu aufgefordert wirst, wähle Create a new repository on GitHub from scratch aus, und gib den Namen deines neuen Projekts ein. Wenn dein Projekt nicht zu deinem persönlichen Konto, sondern zu einer Organisation gehören soll, musst du mithilfe von organization-name/project-name den Organisationsnamen und den Projektnamen angeben.
  3. Befolge die interaktiven Eingabeaufforderungen. Um das Repository lokal zu klonen, bestätige mit „Yes“, wenn gefragt wirst, ob du das Remoteprojektverzeichnis klonen möchtest.
  4. Um die Eingabeaufforderungen zu überspringen, gibst du alternativ den Repositorynamen und ein Sichtbarkeitsflag an (--public, --private oder --internal). Beispiel: gh repo create project-name --public. Um das Repository lokal zu klonen, übergib das --clone-Flag. Weitere Informationen zu möglichen Argumenten findest du im GitHub CLI-Handbuch.

Die erste Änderung freigeben

Ein Commit ist wie eine Momentaufnahme aller Dateien in deinem Projekt zu einem bestimmten Zeitpunkt.

Als du dein neues Repository erstellt hast, hast du es mit einer README-Datei initialisiert. README-Dateien bieten Platz, um das Projekt detaillierter zu beschreiben oder weitere Dokumentation hinzuzufügen, z. B. Informationen zum Installieren oder Verwenden deines Projekts. Der Inhalt deiner README-Datei wird automatisch auf der Hauptseite deines Repositorys angezeigt.

Lass uns eine Änderung an der README-Datei committen.

  1. Wähle in der Dateiliste deines Repositorys die Datei README.md aus.

    Screenshot der Liste der Dateien in einem Repository. Der Dateiname „README.md“ ist orange umrandet.

  2. Klicke zum Öffnen des Datei-Editors oben rechts in der Dateiansicht auf .

Screenshot einer Datei. In der Kopfzeile ist eine Schaltfläche mit Stiftsymbol dunkelorange umrandet.

  1. Gib im Textfeld Informationen zu deiner Person ein.

  2. Klicke oberhalb des neuen Inhalts auf Vorschau.

    Screenshot einer Datei im Bearbeitungsmodus über dem Inhalt der Datei befindet sich die orange umrandete Registerkarte „Vorschau“.

  3. Überprüfe die Änderungen, die du an der Datei vorgenommen hast. Wenn du Unterschied anzeigen auswählst, wird der neue Inhalt in Grün angezeigt.

    Screenshot der Registerkarte „Vorschau“ für eine Datei. Ein Kontrollkästchen mit der Bezeichnung „Unterschied anzeigen“ ist aktiviert, und eine Ergänzung der Datei wird durch eine grüne Linienmarkierung angezeigt. Beide sind orangefarben umrandet.

  4. Klicke auf Änderungen committen... .

  5. Gib im Feld „Commitnachricht“ eine kurze, aussagekräftige Commitnachricht ein, die die Änderung beschreibt, die Du an der Datei vorgenommen hast. Du kannst den Commit in der Commit-Mitteilung mehr als einem Autor zuordnen. Weitere Informationen findest du unter Einen Commit mit mehreren Autoren erstellen.

  6. Lege unter den Commit-Mitteilungsfeldern fest, ob Du Dein Commit zum aktuellen Branch oder zu einem neuen Branch hinzufügen möchten. Wenn dein aktueller Branch als Standardbranch festgelegt ist, solltest du einen neuen Branch für deinen Commit und dann einen Pull Request erstellen. Weitere Informationen findest du unter Erstellen eines Pull Requests.

    Screenshot eines GitHub-Pull Requests mit einem Optionsfeld zum direkten Commit an den Mainbranch oder zum Erstellen eines neuen Branchs. Der neue Branch ist ausgewählt.

  7. Klicke auf Änderungen committen oder Änderungen vorschlagen.

Nachdem du ein Projekt erstellt hast, kannst du mit dem Committen von Änderungen beginnen.

README-Dateien bieten Platz, um das Projekt detaillierter zu beschreiben oder weitere Dokumentation hinzuzufügen, z. B. Informationen zum Installieren oder Verwenden deines Projekts. Der Inhalt deiner README-Datei wird automatisch auf der Hauptseite deines Repositorys angezeigt. Führe die folgenden Schritte aus, um eine README-Datei hinzuzufügen.

  1. Navigiere in der Befehlszeile zum Stammverzeichnis deines neuen Projekts. (Dieses Verzeichnis wurde erstellt, als du den Befehl gh repo create ausgeführt hast.)

  2. Erstelle eine README-Datei mit Informationen zum Projekt.

    echo "info about this project" >> README.md

  3. Geben Sie git status ein. Du stellst fest, dass du über eine nicht nachverfolgte README.md-Datei verfügst.

    $ git status

Untracked files:
  (use "git add <file>..." to include in what will be committed)
  README.md

nothing added to commit but untracked files present (use "git add" to track)

  4. Stage und committe die Datei.

    git add README.md && git commit -m "Add README"

  5. Pushe die Änderungen auf den Branch.

    git push --set-upstream origin HEAD

Nächste Schritte

Sie haben jetzt ein Repository mitsamt einer README-Datei und Ihren ersten Commit auf GitHub erstellt.

  • Du kannst jetzt ein GitHub-Repository klonen, um eine lokale Kopie auf deinem Computer zu erstellen. In deinem lokalen Repository kannst du eine Pull Request committen und erstellen, um die Änderungen im Upstream-Repository zu aktualisieren. Weitere Informationen findest du unter Ein Repository klonen und Einrichten von Git.

  • Auf GitHub findest du interessante Projekte und Repositorys, die du ändern kannst, indem du das Repository forkst. Durch das Forken eines Repositorys kannst du Änderungen an einem anderen Repository vornehmen, ohne das Original zu beeinträchtigen. Weitere Informationen findest du unter Ein Repository forken.

  • Jedes Repository auf GitHub gehört einer Person oder einer Organisation. Du kannst mit den Personen, Repositorys und Organisationen interagieren, indem du eine Verbindung herstellst und sie auf GitHub verfolgst. Weitere Informationen findest du unter Inspiration auf GitHub finden.

  • GitHub verfügt über eine großartige Supportcommunity, in der du um Hilfe bitten und mit Menschen aus der ganzen Welt sprechen kannst. Nimm an der Unterhaltung auf GitHub Community teil.