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

Other languages:
aragonés • ‎العربية • ‎asturianu • ‎تۆرکجه • ‎беларуская (тарашкевіца)‎ • ‎български • ‎català • ‎čeština • ‎dansk • ‎Deutsch • ‎Ελληνικά • ‎English • ‎Esperanto • ‎español • ‎euskara • ‎فارسی • ‎suomi • ‎français • ‎galego • ‎Hawaiʻi • ‎עברית • ‎हिन्दी • ‎hrvatski • ‎magyar • ‎Հայերեն • ‎interlingua • ‎Bahasa Indonesia • ‎Interlingue • ‎italiano • ‎日本語 • ‎ქართული • ‎Taqbaylit • ‎한국어 • ‎kurdî • ‎Lëtzebuergesch • ‎lietuvių • ‎Bahasa Melayu • ‎Napulitano • ‎norsk bokmål • ‎नेपाली • ‎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 --branch REL1_31 Installationsort

Dies kopiert das gesamte MediaWiki-Kernrepository, das ursprünglich auf den Versionszweig 1.31 verweist, in ein Unterverzeichnis namens install-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 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 install-dir
git submodule update --init

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 --branch REL1_31 install-dir

Externe Bibliotheken holen

Wir benutzen Composer um sie zu verwalten.

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

  • Wenn du Composer nicht verwenden willst, oder wenn du dasselbe Set von Anbieterbibliotheken verwenden willst, das auf dem WMF-Produktionscluster verwendet wird, dann führe git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git aus, um ein vendor/-Verzeichnis im Hauptverzeichnis deiner MediaWiki-Installation anzulegen.

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:

You can see all available tags with:

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


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 den Befehl git 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.

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

composer update --no-dev

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


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

Entwickler klonen mit:

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

Man kann sich den Quellcode der Erweiterung in der Anwendung Phabricator's diffusion 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/p/mediawiki/extensions.git --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