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 97% complete.

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Lëtzebuergesch • ‎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 • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎татарча/tatarça • ‎українська • ‎հայերեն • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎नेपाली • ‎हिन्दी • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
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 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/p/mediawiki/core.git --branch REL1_31 mediawiki

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

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 verfolgen. Der Entwicklungszweig, master, ist die innovative Entwicklerversion von MediaWiki. Sie sollten unter keinen Umständen den master-Code auf laufenden Systemen verwenden, da dieser instabil ist.

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

Dass die Versionszweige eine Menge Git-Submodule enthalten, für häufig verwendete Erweiterungen und Skins (der Masterzweig hat diese nicht). Um die Submodule zu aktualisieren, führen Sie Folgendes aus:

cd mediawiki
git submodule update --init

Download für Entwickler

Wenn Sie einen Entwickleraccount 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 mediawiki

Dabei clont mann den Kern des ganze MediaWiki Repo, das sich mit dem Meisterbranch synchronisiert, im Unterordner, der mediawiki nannte.

Externe Bibliotheken holen

MediaWiki benutzt Composer um die externen PHP-Bibliotheken zu verwalten, die im vendor/ Ordner ihres MediaWiki Ordners liegen.

Um diese benötigten Bibliotheken zu installieren, habe Sie folgende Wahl:

  • Wenn Sie Composer nicht verwenden wollen, oder wenn Sie dasselbes Set von Anbieterbibliotheken verwenden wollen, das auf dem WMF-Produktionscluster verwendet wird, dann führen git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git aus, um ein vendor/-Verzeichnis im Hauptverzeichnis Ihrer MediaWiki-Installation anzulegen. Merken Sie daran, dass wenn eine Ihrer Erweiterungen seine eigenen Anforderungen hat, dann "Sie können diese Option nicht verwenden".

Ab MediaWiki 1.25 sind einige externe Bibliotheken, die MediaWiki benötigt nicht länger in diesem "core"-git-Repository.

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:

Sie können alle verfügbaren Tagen damit sehen:

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 1.31.1

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 ziemlich einfach, die letzten Änderungen zu holen. Wechseln Sie in Ihr MediaWiki Klon-Verzeichnis und geben Sie diesen Befehl 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-submodulesgit pull --recurse-submodules aktualisieren müssen.

Sie müssen außerdem vendor auf jegliche neuere Version der benötigten Bibliotheken aktualisieren. Siehe dazu #Fetch external libraries. In den meisten Fällen reicht der folgende Composer Befehl:

composer update --no-dev

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

php maintenance/update.php

Wenn Sie MediaWiki-Vagrant nutzen, können Sie alle diese Schritte mit einem einzelnen Befehl, vagrant git-updatevagrant 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: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> --branch REL1_31

Entwickler klonen mit:

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

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 Sie lieber alle MediaWiki-Erweiterunge, bei gerrit.wikimedia.org auschecken wollen, gehen Sie folgendermaßen vor:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_31
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

Um zu einem anderen Zweig zu wechseln, wie nach einem neuem Release:

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

Es sollte beachtet werden, dass nur Versionen von Erweiterungen von der gleichen Veröffentlichung wie die Version von MediaWiki verwendet werden sollten und umgekehrt.

Um den Hauptzweig zu verfolgen:

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

Bitte beachten: den "Master Code for production" nicht nutzen da dieser als nicht stabil gilt.

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 …" oder "wfLoadExtension( … )" 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