Download von Git

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

Other languages:
aragonés • ‎العربية • ‎asturianu • ‎تۆرکجه • ‎беларуская (тарашкевіца)‎ • ‎български • ‎català • ‎čeština • ‎dansk • ‎Deutsch • ‎Ελληνικά • ‎English • ‎Esperanto • ‎español • ‎euskara • ‎فارسی • ‎suomi • ‎français • ‎galego • ‎Hawaiʻi • ‎עברית • ‎magyar • ‎Հայերեն • ‎Bahasa Indonesia • ‎Interlingue • ‎italiano • ‎日本語 • ‎ქართული • ‎Taqbaylit • ‎한국어 • ‎Lëtzebuergesch • ‎lietuvių • ‎Bahasa Melayu • ‎Napulitano • ‎नेपाली • ‎Nederlands • ‎occitan • ‎polski • ‎پښتو • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎sicilianu • ‎Scots • ‎سنڌي • ‎slovenčina • ‎српски / srpski • ‎svenska • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎Türkçe • ‎татарча/tatarça • ‎ئۇيغۇرچە • ‎українська • ‎Tiếng Việt • ‎ייִדיש • ‎粵語 • ‎中文
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 Zweiges herunterzuladen, ohne dass man darauf warten muss, dass jemand sie packetiert. MediaWiki wird schneller veröffentlicht und es wird einfacher für Sie, Ihre Installation zu aktualisieren, eine Aktualisierung zurückzurollen, oder Patches einzureichen. (Natürlich immer daran denken, dass die offiziellen, stabilen Versionen weniger riskant sind.)

Siehe Git für weitere Details, insbesondere um Beiträge zu erstellen. Unten sind einige kurze Anleitungen für einige häufige Aufgaben.

Voraussetzungen

Sie müssen Git installiert haben, bevor Sie es benutzen können. Es gibt viele Möglichkeiten Git zu bekommen, in Abhängigkeit von Ihrem Betriebssystem. Für Quell- und offizielle Binärdateien, sehen Sie sich auf git-scm.com um. Für alternative Wege Git zu installieren, benutzen Sie ihre bevorzugte Suchmaschine um Anweisungen zu ihrem Betriebssystem zu finden.

Es wird empfohlen, composer zum Herunterladen und Installieren von Bibliotheken Dritter zu installieren, aber das ist nicht notwendig.

MediaWiki mit Git herunterladen

Herunterladen

Mit Git können Sie den MediaWiki-core herunterladen wie auch alle Erweiterungen, die aktuell auf dem Wikimedia Foundation Serververbund installiert sind und viele andere Erweiterungen, die auf Gerritgerrit 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/p/mediawiki/core.git

Dies dupliziert das gesamte MediaWiki-Core-Repositorium in ein Unterverzeichnis namens core. Um in ein bestimmtes Verzeichnis zu installieren, fügen Sie dies dem Befehl hinzu (für weitere Informationen prüfen Sie diese Unterlagen). Der Standard-"Zweig" wird master, der modernste und zugleich die Entwicklerversion von MediaWiki sein. Sobald das Repositorium dupliziert wurde, können Sie einfach zu anderen Zweigen oder Tags wechseln (siehe unten), einschließlich der "Stable"-Versionen von MediaWiki.

Download für Entwickler

Wenn Sie Entwicklerzugang haben (was einfach zu erfragen ist), sollten Sie, anstatt anonym über https, die Duplizierung mit Ihrem ssh "<USERNAME>" vornehmen, sodass Sie Änderungen zur Überprüfung einreichen können:

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

Externe Bibliotheken holen

Ab MediaWiki 1.25 sind einige externe Bibliotheken, die MediaWiki benötigt nicht länger in diesem "core"-git-Repository. Wir benutzen Composer um sie zu verwalten. Um diese benötigten Bibliotheken zu installieren, habe Sie folgende Wahl:

  • Downloade und installiere Composer, wechsle in das core-Verzeichnis und lass dann composer install --no-dev laufen. Beachte, dass wenn Du eine existierende composer.lock-Datei hast, Du stattdessen composer update --no-dev laufen lassen musst.
  • Wenn Du Composer nicht verwenden willst, oder wenn Du dasselbe Set von Anbieterbibliotheken verwenden willst, das auf dem WMF-Produktionscluster verwendet wird, dann nimm stattdessen git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git, um ein vendor/-Verzeichnis im core-Verzeichnis Deiner MediaWiki-Installation anzulegen. Stellen Sie sicher, dass Sie den richtigen Zweig für Ihre MediaWiki-Version verwenden (z.B. REL1_25 für 1.25).

Spezifische MediaWiki-Versionen

WMF-Zweige

Entfernte Branches werden verwendet, um den MediaWiki-Versionen zu folgen, die auf dem Wikimedia Foundation Server-Cluster aktuell eingesetzt sind. Diese sind möglicherweise nicht ganz stabil, erhalten aber sehr schnell Bugfixes und sind in der Regel stabil genug – immerhin sind diese das, was Großprojekte wie Wikipedia verwenden. Sobald ein REL*-Branch als 'stabil' betrachtet wird, 'taggen wir es und machen es zu einem Tarball-Release.

Um zu sehen, welche Zweige zur Verfügung stehen, wechseln Sie in Ihr MediaWiki-core-Verzeichnis und geben Sie folgenden Befehl ein:

git branch -r | sort -V

Hauptversionen werden durch 'Herkunft/REL<Versionsnummer>' bezeichnet, z. B. 'origin/REL1_29'. Um zu einem bestimmten Release-Zweig zu wechseln:

git checkout -b REL<Ausgabe Nr.> origin/REL<Ausgabe Nr.>

Um z.B. zur aktuellen stabilen Version 1.29.0 zu wechseln, ist folgende Eingabe nötig:

git checkout -b REL1_29 origin/REL1_29
MediaWiki-Tags (stabile Version)

Alternativ können konkrete stabile Versionen der MediaWiki durch 'Tags' verfolgt werden. Die verfügbaren Versionen sind auf folgende Weise ersichtlich:

git tag -l | sort -V

Nutzen Sie keinen GNU-Sortierbefehl, wie z.B. unter Mac OS X, dann müssen Sie sich auf die guten alten Separatoren verlassen:

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

Um einen Spezifischen Tag zu benutzen:

git checkout <Tag-Name>

Letzte Entwicklerversion von MediaWiki

Die neueste Entwicklungsversion von MediaWiki wird im "master"-Zweig verfolgt. Dies ist, was standardmäßig aktiviert ist, wenn Sie erstmals das MediaWiki-Repositorium klonen. Wenn Sie zu einem anderen Zweig gewechselt haben, aber zurück wechseln möchten, um "bleeding-edge" MediaWiki zu nutzen, tun sie:

git checkout master


Aktuell halten

Wenn Sie einen bestimmten Zweig oder die Entwicklungsversion ("Masterzweig") von MediaWiki nutzen, ist es wirklich einfach, die letzten Änderungen zu holen. Wechseln Sie in Ihr MediaWiki Klon-Verzeichnis und geben Sie den Befehl pull ein:

git pull

Alle aktuellen Änderungen werden auf den Zweig angewendet, den Sie nutzen werden.

Die neue Version von core kann neue Versionen der Erweiterungen oder Gestaltungen erfordern, sodass Sie in jedes Erweiterungs- und Gestaltungs-Verzeichnis wechseln und es mit einem Befehl wie git pull --recurse-submodules aktualisieren müssen.

Nach einer Aktualisierung/Hochstufung sollten Sie das MediaWiki update.phpManual:update.php von der Befehlszeile ausführen, um benötigte Datenbankentabellen zu aktualisieren:

php maintenance/update.php

Sie müssen außerdem mediawiki/vendor auf jegliche neuere Version der benötigten Bibliotheken aktualisieren. Siehe dazu #Fetch external libraries.

Wenn Sie MediaWiki-Vagrant nutzen, können Sie alle diese Schritte mit einem einzelnen 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 verfolgt. Um zu einen von diesen zu wechseln, müssen Sie einfach nur den gewünschten Zweig 'auschecken' oder markieren, während Sie in Ihrem MediaWiki Klon-Verzeichnis sind:

git checkout <Branch-Name>

oder

git checkout <Tag-Name>

Änderungen werden automatisch umgesetzt und du bist fertig.

MediaWiki-Erweiterungen per Git herunterladen

Liste von Erweiterungen auf git

Eine Erweiterung herunterladen

<EXT> sollte mit dem Namen der Erweiterung, die Sie herunterladen wollen ersetzen werden, ohne Leerzeichen. Für Erweiterung:TitleKeyExtension: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/p/mediawiki/extensions/<EXT>.git

Entwickler klonen mit:

git clone ssh://<Benutzername>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT>.git

Man kann sich den Quellcode der Erweiterung ansehen in der Anwendung Phabricator's diffusion und auf der URL:

https://gerrit.wikimedia.org/r/gitweb?p=mediawiki/extensions/<EXT>.git;a=tree;h=refs/heads/master;hb=master

Alle Erweiterungen herunterladen

Wenn Sie lieber alle MediaWiki-Erweiterunge, bei gerrit.wikimedia.org auschecken wollen, gehen Sie folgendermaßen vor:

git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions.git
cd extensions
git submodule update --init --recursive

Um alle Erweiterungen zur letzten verfügbaren Version zu aktualisieren, sind folgende Schritte notwendig:

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

So verfolgen Sie einen bestimmten Zweig:

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

Wenn nur ein Checkout mit Leserechten benötigt wird (z. B. um den ganzen MediaWiki-Code zu greppen oder zu analysieren), kann man den Geteilten MediaWiki -Checkout bei Labs benutzen ohne etwas auf die eigenen Rechner runterzuladen.

Eine Erweiterung entfernen

Entferne einfach das Erweiterungsverzeichnis und entferne den "require_once …" aus LocalSettings.php.

MediaWiki mit Git herunterladen

Liste von Gestaltungen auf git

MediaWiki 1.24 und später enthalten keine Skins im Git Download.

Genau der gleiche Vorgang wie für Erweiterungen (im vorigen Abschnitt beschrieben), jedoch mit 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. Anweisungen für alle anderen Skins liegen analog vor.

Siehe auch