Download from Git/de

Git ist ein System zur Verwaltung von verteilten Softwareversionen. Es ermöglicht das Herunterladen der letzten Version des Quellcodes inklusive aller Abspaltungen und markierten Versionen ganz nach den eigenen Vorstellungen.

Der Download über Git sollte genutzt werden, wenn man ein Entwickler ist und Änderungen beitragen möchte.

Wenn man nichts entwickeln möchte, sondern nur MediaWiki und die Erweiterungen installieren möchte, sollte man ausgereifte und vollständige Versionen herunterladen.

Siehe Git für weitere Details, insbesondere, wenn es darum geht, zu Artikeln/Programmen beizutragen. Im Folgenden findest Du einige kurze Anweisungen für manche häufig ausgeführte Aufgaben.

Voraussetzungen
Du musst Git installiert haben, bevor Du es benutzen kannst. Es gibt viele Möglichkeiten, Git zu erwerben, abhängig von Deinem Betriebssystem. Folge Gerrit/Tutorial#Set up Git, oder verwende deine bevorzugte Suchmaschine.

Es wird empfohlen, ist aber nicht zwingend notwendig, zuvor installiert zu haben und Bibliotheken Dritter zu installieren.



Herunterladen
Mit Git kannst Du den MediaWiki-core herunterladen wie auch alle Erweiterungen, die aktuell auf dem Wikimedia Foundation Serververbund installiert sind, ebenso viele andere Erweiterungen, die auf  bereitgestellt werden.

Der erste Schritt ist das Klonen des MediaWiki-Core-Repositoriums. Dies kann eine Weile dauern.



Download für Entwickler
Die neueste Entwicklungsversion von MediaWiki wird im "Master"-Zweig nachverfolgt.

Stelle zuerst sicher, dass du ein Entwicklerkonto erstellt hast, sodass du einen ssh-Benutzernamen hast.

Gib in einem Befehlszeilenfenster folgenden Befehl ein, um mit deinen ssh zu klonen, damit du Patches zur Überprüfung einreichen kannst:

Dadurch wird das gesamte MediaWiki-Kernrepository, das mit dem Hauptzweig synchronisiert ist, in ein Unterverzeichnis mit dem Namen  geklont.

Um in ein anderes Verzeichnis zu installieren, ändere den Befehl in der Kommandozeile (mehr Informationen unter ). Wenn das Repository kopiert wurde, kannst du einfach zu den unterschiedlichen Versionszweigen oder Tags wechseln (siehe unten), einschließlich solcher, die instabile Versionen von MediaWiki nachverfolgen. Der Entwicklungszweig,, ist die neueste  Entwicklerversion von MediaWiki. Du solltest unter keinen Umständen den -Code auf laufenden Systemen verwenden, da er nicht als stabil angesehen wird.





Einen stabilen Zweig herunterladen
Solltest du keine Software-Patches entwickeln wollen, sondern nur anonym eine Kopie vom stabilen Release-Branch erstellen wollen, verwende dieses Kommando:

Wenn du die Anzahl der Überarbeitungen, die kopiert wurden, reduzieren möchtest, füge  zu obigem Befehl hinzu.



MediaWiki-Tags (stabile Version)
Alternativ können bestimmte stabile Versionen von MediaWiki mithilfe von "Tags" nachverfolgt werden. Diese sind analog zu den Tarball-Veröffentlichungen. Derzeit sind dies (stabil),  (LTS) und  (legacy).

Du kannst alle verfügbaren Tags sehen mit:

Um einen spezifischen Tag zu benutzen, z. B. die neueste stabile Version:



Aktualisiere die Git-Submodule
Die Zweige und Tags enthalten eine Reihe von Git-Submodulen für häufig verwendete Erweiterungen und Skins und für das -Verzeichnis. Der -Zweig hat diese nicht. Um die Submodule zu aktualisieren, führe aus:



Externe Bibliotheken abrufen
MediaWiki benutzt, um die externen PHP-Bibliotheken zu verwalten, die allesamt im -Ordner deines MediaWiki-Ordners liegen.

Um diese benötigten Bibliotheken zu installieren, hast Du folgende Möglichkeiten:


 * Lade das "composer PHAR" herunter, benenne es gegebenenfalls entsprechend der Anleitung für dein Betriebssystem um und führe anschließend  in deinem MediaWiki-Verzeichnis aus. Dies ist die empfohlene Vorgehensweise.
 * Wenn die Standard-PHP-CLI-Version nicht der der PHP-Version des Webservers übereinstimmt, gebe es mit z.B. mit  an.
 * Wenn Du Composer nicht verwenden willst, oder wenn Du dasselbe Set von Anbieterbibliotheken verwenden willst, das auf dem WMF-Produktionscluster verwendet wird, dann erstelle ein -Verzeichnis im Hauptverzeichnis Deiner MediaWiki-Installation:
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * Beachte: Wenn irgendwelche Deiner Erweiterungen ihre eigenen Composer-Anforderungen haben, dann kannst Du diese Option nicht verwenden.

Vor MediaWiki 1.25 wurden externe Bibliotheken im Core-Repository gespeichert, deshalb war kein Paketmanager erforderlich.



Bleibe auf dem Laufenden
Wenn Du einen bestimmten Zweig oder die Entwicklungsversion ("Masterzweig") von MediaWiki benutzt, ist es ziemlich einfach, die letzten Änderungen abzurufen. Wechsle zu Deinem MediaWiki Klon-Verzeichnis und gib diesen Befehl ein:

Alle aktuellen Änderungen werden auf den Zweig angewendet, den Du benutzen wirst.

Die neue Version von Core kann neue Versionen der Erweiterungen oder Oberflächen erfordern, sodass Du in jedes Erweiterungs- und Oberflächen-Verzeichnis wechseln und es mit einem Befehl wie  aktualisieren musst.

Du musst ebenfalls  aktualisieren, wenn neuere Version der benötigten Bibliotheken verfügbar sind. Dies bedeutet häufig, dass der folgende Composer-Befehl ausgeführt werden muss. Weitere Informationen findest Du oben in #Fetch external libraries:

Nach einem Update/Upgrade des Codes und der erforderlichen Bibliotheken solltest Du das Befehlszeilenskript MediaWiki  ausführen, um die Datenbanktabellen nach Bedarf zu aktualisieren:

Wenn Du benutzt, kannst Du alle diese Schritte mit einem einzigen Befehl, , ausführen.



Zu einer anderen Version wechseln
Jede unserer Versionen wird als Zweig oder Tag nachverfolgt. Um zu einem dieser Verzeichnisse zu wechseln (bspw. vom -Zweig zu einem Entwicklungszweig), musst Du einfach nur den Zweig oder Tag aus Deinem MediaWiki-Klonverzeichnis checkout auswählen:

oder

Die Änderungen werden automatisch übernommen und Du kannst loslegen.



MediaWiki-Erweiterungen per Git herunterladen

 * Liste von Erweiterungen auf git



Eine Erweiterung herunterladen

 *  sollte mit dem Namen der Erweiterung, ohne Leerzeichen, ersetzt werden. Für wäre es TitleKey. (Groß- und Kleinschreibung beachten!) 

Herunterladen und Klonen einer Erweiterung aus Git:

With your developer account, use these commands to get the master branch:

For anonymous checkout of the stable branch instead, use these commands:

Man kann sich den Quellcode der Erweiterung in der Gerrit's gitiles-Anwendung und unter folgender URL ansehen:

 https://gerrit.wikimedia.org/g/mediawiki/extensions//+/refs/heads/master



Alle Erweiterungen herunterladen
Wenn Du lieber alle MediaWiki-Erweiterungen bei gerrit.wikimedia.org überprüfen willst, gehe folgendermaßen vor:

With your developer account, to get the master branch:

For anonymous checkout of the stable branch instead, use this command:

After running the  command, continue with these commands:

Gib anschließend Folgendes ein, um alle Erweiterungen auf die neuesten Versionen dieses Zweigs zu aktualisieren:

So wechselst Du in einen anderen Zweig, beispielsweise nach Erscheinen einer neuen Version:

Denke daran, dass Du nur Versionen von Erweiterungen aus demselben Release wie der Version von MediaWiki und untereinander verwenden solltest.

Um den Hauptzweig zu verfolgen:

Bitte beachte, dass Du unter keinen Umständen den "Master Code for production" benutzen solltest, da dieser als nicht stabil gilt.

Wenn Du nur eine Überprüfung im Nur-Lese-Modus benötigst (um beispielsweise den gesamten MediaWiki-Code zu prüfen oder zu analysieren), kannst Du die Shared MediaWiki-Prüfung in Labs verwenden, ohne etwas auf Deinen Rechner herunterladen zu müssen.



Eine Erweiterung entfernen

 * 1) Entferne den " " oder " " aus.
 * 2) Beliebige Zeile, welche die Erweiterung erwähnt, in  entfernen (normalerweise im Kapitel "Extra --> Plugin zusammenführen --> einfügen")
 * 3) Das Erweiterungsverzeichnis in   entfernen.



MediaWiki-Oberflächen mit Git herunterladen

 * Liste von Oberflächen auf git

MediaWiki 1.24 und später enthalten keine Oberflächen beim Herunterladen von Git.

Führe genau den gleiche Vorgang aus wie für Erweiterungen (im vorigen Abschnitt beschrieben), jedoch unter Verwendung von  anstatt von   in allen URLs und Pfaden.

Detaillierte Installationanweisungen sind auf jeder Skin-Seite hier auf MediaWiki.org verfügbar, zum Beispiel unter Skin:Vector#Installation (Vector-Installation). Anweisungen für alle anderen Skins liegen analog vor.



Siehe auch

 * Intranet/Intranet-Installation, Teil einer vollständig ausgearbeiteten Serie von Artikeln, die Git für die Entwicklung von MediaWiki verwendet

Anhang
The Revision as of 14:26, 21 March 2019 changed the standard of linking to gerrit.wikimedia.org:

from:
 * gerrit.wikimedia.org/r/ p /mediawiki

to:
 * gerrit.wikimedia.org/r/mediawiki