Outdated translations are marked like this.
- Dies ist eine sehr kurze (tl;dr) Anleitung zur Verwendung von Git und Gerrit für die MediaWiki-Entwicklung. Ein Tutorial mit Erläuterungen finden Sie unter Gerrit/Anleitung.
Erste Schritte:
- Installiere und konfiguriere Git.
- Erstelle einen SSH-Schlüssel (die Schritte 1-3 reichen für Gerrit). Erstelle ein Wikimedia-Entwicklerkonto.
- Melde dich an und füge deinen öffentlichen Schlüssel zu gerrit hinzu.
- Füge deinen öffentlichen Schlüssel auch zu LDAP hinzu, indem du die toolsadmin-Schnittstelle oder Special:NovaKey auf wikitech verwendest.
- Installiere und richte git-review ein. and set it up.
 Warnung: | To interact with Toolsadmin/Wikitech and/or Gerrit, developers must use different SSH keys than the ones they use to connect to production servers. Production access is extremely sensitive and "Prod Keys" should never be used in things other than production instances. |
Hole den Code:
- Für den MediaWiki-Kern:
git clone ssh://<benutzername>@gerrit.wikimedia.org:29418/mediawiki/core.git mediawiki - Oder für eine Erweiterung:
git clone ssh://<benutzername>@gerrit.wikimedia.org:29418/mediawiki/extensions/<erweiterung>.git - Oder für ein Skin:
git clone ssh://<benutzername>@gerrit.wikimedia.org:29418/mediawiki/skins/<skinname>.git
Schreibe und sende neuen Code:
git checkout mastergit pullgit checkout -b <meaningful-branch-name># Jetzt schreibe etwas Code. Siehe die Git-Befehle "add", "rm" und "mv" zum Hinzufügen, Entfernen oder Umbenennen von Dateien. Wenn der Code fertig ist:git commit --all # In der Gerrit-Welt solltest du das nur einmal pro Zweig tun! Denke daran, die Commit-Nachrichtenrichtlinien zu befolgen.git show # Vergewissere dich, dass du das sendest, was du senden willst. Drücke "q", um zu beenden.git review -R # Dadurch wird dein Code an Gerrit gesendet.- Wenn du Fehler mit dem Schalter "-R" erhältst, verwendest du möglicherweise veraltete "gerrit-tools" statt "git-review".
Potenzielle Prüfer für Änderungen hinzufügen:
- Klicke bei Gerrit auf deine Änderung. Klicke unter "Reviewers" auf die Schaltfläche "Add Reviewer". Schreibe den Namen eines Überprüfers in das Eingabefeld. Wenn du nicht weißt, wen du zum Überprüfen einladen sollst, versuche es bei dem Maintainer für die Komponente, die du bearbeitet hast, oder frage auf IRC (#wikimedia-dev connect).
Wenn der Prüfer dich bittet, eine Änderung vorzunehmen, nimm sie vor und ergänze deinen Commit:
git review -d <ID oder URL des Patches ändern> # z.B. 1234 in gerrit.wikimedia.org/r/1234 oder https://gerrit.wikimedia.org/r/c/mediawiki/core/+/1234# Nimm die erforderlichen Änderungen an den Quelldateien vor.git commit --all --amend # Du kannst dies mehr als einmal tun. Du kannst die Commit-Nachricht ändern, achte jedoch darauf, die "Change-Id"-Zeile beizubehalten.git review -R # Dadurch wird ein neues Patch-Set in derselben Gerrit-Änderung erstellt und eine Einladung zur erneuten Überprüfung des Codes gesendet.
Um Code anderer Leute zu überprüfen, befolge einfach die oben beschriebenen Schritte zum Ändern einer Änderung und verwende die entsprechende <change ID>.