Herunterladen von Git

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Download from Git and the translation is 100% complete.

Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎українська • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎हिन्दी • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
Seit MediaWiki 1.19beta2, 1.18.2, 1.17.3, benutzen der MediaWiki-Kern und Erweiterungen Git zur Versionskontrolle. Für ältere Versionen, siehe Subversion.

Git ist eine verbreitete Software zur Versionskontrolle, die es Benutzern ermöglicht, die allerneueste Version eines Teilgebietes herunterzuladen, ohne darauf warten zu müssen, dass jemand sie ins Package packt. MediaWiki wird schneller veröffentlicht und es wird für Dich einfacher sein, Deine Installation zu aktualisieren, ein Upgrade rückgängig zu machen oder submit patches (Patches einzureichen). (Denke natürlich immer daran, dass offizielle, als stabil freigegebene Veröffentlichungen weniger riskant sind.)

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. Für Quellcode und offizielle Binärdateien, suche auf git-scm.com. Für alternative Wege Git zu installieren, benutze Deine bevorzugte Suchmaschine um Anweisungen zu Deinem Betriebssystem zu finden.

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

MediaWiki mit Git herunterladen

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. Dies kann eine Weile dauern.

Gib in einem Befehlszeilenfenster folgenden Befehl ein:

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

Dies kopiert das gesamte MediaWiki-Kernrepository, das ursprünglich auf den Versionszweig 1.33 verweist, in ein Unterverzeichnis namens mediawiki.

Um in ein anderes Verzeichnis zu installieren, ändere den Befehl in der Kommandozeile (mehr Informationen unter [1]). 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, master, ist die neueste Entwicklerversion von MediaWiki. Du solltest unter keinen Umständen den master-Code auf laufenden Systemen verwenden, da er nicht als stabil angesehen wird.

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

Die Release-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:

cd mediawiki
git submodule update --init

Download für Entwickler

Wenn Du einen Entwickleraccount hast (was einfach zu beantragen ist), solltest Du, anstatt anonym über https, die Duplizierung mit Deinem "<USERNAME>" (Benutzername) vornehmen, damit Du Änderungen zur Überprüfung einreichen kannst:

git clone ssh://<BENUTZERNAME>@gerrit.wikimedia.org:29418/mediawiki/core.git mediawiki

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

Externe Bibliotheken abrufen

MediaWiki benutzt Composer um die externen PHP-Bibliotheken zu verwalten, die allesamt im vendor/</code- 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 das selbe Set von Anbieterbibliotheken verwenden willst, das auf dem WMF-Produktionscluster verwendet wird, dann führe git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git aus, um ein vendor/-Verzeichnis im Hauptverzeichnis Deiner MediaWiki-Installation anzulegen. 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.

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 1.33.0 (stabil), 1.31.3 (LTS) und 1.32.3 (legacy).

Du kannst alle verfügbaren Tags sehen mit:

git tag -l | sort -V

Wenn Du keinen GNU-Sortierbefehl benutzt, wie z.B. unter Mac OS X, dann musst Du Dich auf die guten alten Separatoren verlassen:

git tag -l | sort -n -t. -k1 -k2 -k3

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

git checkout 1.33.0

Letzte Entwicklerversion von MediaWiki

Die neueste Entwicklungsversion von MediaWiki wird im "Master"-Zweig nachverfolgt. Dies wird standardmäßig lokal überprüft, wenn Du das MediaWiki-Repository zum ersten Mal klonst. Wenn Du zu einem anderen Zweig gewechselt bist, aber wieder das neueste MediaWiki verwenden möchtest, gehe wie folgt vor:

git checkout master

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 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 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

Der Wechsel zu einer anderen Version von MediaWiki ist mit Git einfacher als mit SVN. Jede unserer Versionen werden als Zweige oder Tags nachverfolgt. Um zu einem dieser Verzeichnisse zu wechseln, 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.

MediaWiki-Erweiterungen per Git herunterladen

Liste von Erweiterungen auf git

Eine Erweiterung herunterladen

<EXT> sollte mit dem Namen der Erweiterung, ohne Leerzeichen. Für Extension:TitleKey wäre es TitleKey. (Groß-/Kleinschreibung!)

Herunterladen und Klonen einer Erweiterung aus Git:

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

Entwickler klonen mit:

git clone ssh://<BENUTZERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT> --branch REL1_33

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:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_33
cd 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_32 origin/REL1_32 || :'

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

Entferne den "require_once …" oder "wfLoadExtension( … )" aus LocalSettings.php.

  1. Beliebige Zeile, welche die Erweiterung erwähnt in composer.local.json entfernen (normalerweise im Kapitel "Extra --> Plugin zusammenführen --> einfügen")
  2. Das Erweiterungsverzeichnis in install-dir/extensions/ 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 skins anstatt von extensions 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