MediaWiki/Git

topic - Kurzbeschreibung

Testfragen

Testfrage 1

Antwort1

Testfrage 2

Antwort2

Testfrage 3

Antwort3

Testfrage 4

Antwort4

Testfrage 5

Antwort5

TMP

Git ist ein System zur Verwaltung von verteilten Softwareversionen. Es ermöglicht das Herunterladen der letzten Version des inklusive aller 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.

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 Composer installiert zu haben und Bibliotheken Dritter zu installieren.

Download

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 Gerrit bereitgestellt werden.
• Der erste Schritt ist das Klonen des MediaWiki-Core-Repositoriums.

MediaWiki-Tags

Verfügbaren Tags anzeigen sehen

git tag -l | sort -V

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

git checkout 1.37.2

Aktualisieren der Git-Submodule

• Die Zweige enthalten eine Reihe von Git-Submodulen für häufig verwendete Erweiterungen und Skins (der Master-Zweig verfügt nicht über diese Erweiterungen).
• Führe zum Aktualisieren der Submodule Folgendes aus:

mediawiki
git submodule update --init --recursive

Externe Bibliotheken abrufen

MediaWiki benutzt Composer, um die externen PHP-Bibliotheken zu verwalten, die allesamt im vendor/-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 composer update --no-dev in deinem MediaWiki-Verzeichnis aus. Dies ist die empfohlene Vorgehensweise.

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 vendor/-Verzeichnis im Hauptverzeichnis Deiner MediaWiki-Installation:

• • With your developer account, use this command: git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/vendor.git
  • For anonymous checkout, use this command: git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
  • 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:

git pull

• Alle aktuellen Änderungen werden auf den Zweig angewandt, 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 git pull --recurse-submodules aktualisieren musst.
• Du musst ebenfalls vendor/ 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:

composer update --no-dev

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

php maintenance/update.php

Wenn Du MediaWiki-Vagrant benutzt, kannst Du alle diese Schritte mit einem einzigen Befehl, vagrant git-update, 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 master-Zweig zu einem Entwicklungszweig), musst Du einfach nur den Zweig oder Tag aus Deinem MediaWiki-Klonverzeichnis checkout auswählen:

git checkout <Branch-Name>

oder

git checkout <Tag-Name>

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

Erweiterungen

Liste von Erweiterungen auf git

Eine Erweiterung herunterladen

• ‎<EXT> sollte mit dem Namen der Erweiterung, ohne Leerzeichen, ersetzt werden.
• Für Extension:TitleKey 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:

cd /path/to/extensions
git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT>

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

cd /path/to/extensions
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<EXT> --branch REL1_37

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/<EXT>/+/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:

 clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions

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

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_37

After running the git clone command, continue with these commands:

cd /path/to/extensions
git submodule update --init --recursive

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

cd /path/to/extensions
git pull
git submodule update --init --recursive

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

git submodule foreach 'git checkout -b REL1_36 origin/REL1_36 || :'

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:

git submodule foreach 'git checkout -b origin/master || :'

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 "require_once …" oder "wfLoadExtension( … )" aus LocalSettings.php.
2. Beliebige Zeile, welche die Erweiterung erwähnt, in composer.local.json entfernen (normalerweise im Kapitel "Extra --> Plugin zusammenführen --> einfügen")
3. Das Erweiterungsverzeichnis in install-dir/extensions/ entfernen.

MediaWiki-Skins mit Git herunterladen

https://gerrit.wikimedia.org/r/admin/repos/q/filter:mediawiki+skins

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 skins anstatt von extensions in allen URLs und Pfaden.

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

Siehe auch

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

TMP

Download

git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki

Installing

$ git checkout origin/REL1_38

• If you don't already have composer, you need to install it.
• Sometimes it will be named composer.phar instead of composer

$ composer install

Note

• If you don't like composer, you can do a git clone of mediawiki/vendor.git instead
• Just make sure you have the appropriate branch for your version

$ cd extensions
$ git clone <extension I want> -b REL1_38
$ git clone <2nd extension I want> -b REL1_38
...
$ cd ../skins
$ git clone <skin I want> -b REL1_38
...

Update

$ git pull
$ git checkout origin/REL1_27
$ composer update
$ cd extensions

( and for each extension)

$ git pull
$ git checkout origin/REL1_27

(and ditto for skins)

mediawiki # git pull
remote: Counting objects: 23, done
remote: Finding sources: 100% (12/12)
remote: Getting sizes: 100% (22/22)
remote: Compressing objects: 100% (59543/59543)
remote: Total 12 (delta 10), reused 1 (delta 0)
Unpacking objects: 100% (12/12), 3.84 KiB | 655.00 KiB/s, done.
From https://gerrit.wikimedia.org/r/mediawiki/core
   eb85480..7de8cba  REL1_37    -> origin/REL1_37
Updating eb85480..7de8cba
Fast-forward
 includes/cache/LinkCache.php                   | 17 +++++++++--------
 tests/phpunit/includes/cache/LinkCacheTest.php |  3 +++
 tests/phpunit/includes/page/PageStoreTest.php  | 36 ------------------------------------
 3 files changed, 12 insertions(+), 44 deletions(-)

$ cd ../maintenance
$ php update.php