Downloaden uit Git

Git is een gedistribueerd versiebeheer systeem. U kunt de laatste versie downloaden van source code met alle branches en andere versies.

Download uit Git als u een ontwerper bent en patches submit.

Wilt u niet mee ontwerpen maar MediaWiki enkel installeren, download dan stable tarball releases.

Zie Git voor meer details, zeker voor het maken van bijdrages. Hieronder zijn enkele snelle richtlijnen voor een aantal veelvoorkomende zaken.

Vereisten

Git moet geïnstalleerd zijn alvorens gebruik. Er zijn veel verschillende manieren om Git te verkrijgen, afhankelijk van uw besturingssysteem. Volg Gerrit/Tutorial#Set up Git, of gebruik uw favoriete zoekmachine.

Het is aanbevolen, maar niet noodzakelijk, om Composer/nl geïnstalleerd te hebben om bibliotheken van derden te downloaden en installeren.

Git gebruiken om MediaWiki te downloaden

Downloaden

U kunt de MediaWiki core downloaden via Git, evenals alle extensies die nu op de Wikimedia Foundation server cluster geïnstalleerd zijn en vele andere extensies die gehost worden op Gerrit .

Als eerste moet de MediaWiki gekloond worden. Dit zal even duren.

Download voor ontwikkeling

Zie Beknopte handleiding lokaal ontwikkelen voor een korte en snelle uitleg van dit proces.

De laatste ontwikkelaarsversie van MediaWiki wordt gevolgd in de 'master' branch.

Zorg dat u een ontwikkelaarsaccount hebt aangemaakt, zodat uw een ssh gebruikernaam hebt.

Voer het volgende commando in op een console venster om de repository te klonen:

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

Dit kloont de volledige MediaWiki kern repository, gesynchroniseerd met de master branch, in een onderliggende map genaamd mediawiki.

Om op een andere locatie te installeren, wijzig dat in de commando-regel (zie deze documentatie). Wanneer de repository gekloond is, kunt u overschakelen naar andere branches of tags. De ontwikkeling branch, master, is de allernieuwste, ontwikkelversie van MediaWiki; u dient master code niet te gebruiken in productie onder eender welke omstandigheden aangezien deze niet als stabiel wordt beschouwd.

• Bekijk de laatste broncode

Download een stabiele branch

Als u niet actief software patches wilt ontwikkelen, maar alleen de stabiele release branch 1.45 anoniem wilt clonen, gebruik dan dit commando:

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

Indien u het aantal herwerkingen die gekloond worden, wilt verminderen, voeg dan --depth=1 toe aan bovenstaande commando.

MediaWiki labels (stabiele versie)

Als alternatief, specifieke stabiele versies van MediaWiki worden opgevolgd via 'tags'. Nu zijn dit 1.45.3 (stabiel), 1.43.8 (LTS) en 1.43.8 (oud LTS).

U kunt alle beschikbare tags zien met:

git tag -l | sort -V

Om een specifiek label te gebruiken, bijvoorbeeld de laatste stabiele uitgave:

git checkout 1.45.3

Update de Git submodules

De release branches en tags bevatten Git deelmodules, voor veelgebruikte extensies, thema's en voor de map vendor/. De branch master heeft die niet. Om de deelmodules bij te werken, voer uit:

cd mediawiki
git submodule update --init --recursive

Externe bibliotheken ophalen

MediaWiki gebruikt Composer/nl om externe PHP-bibliotheken te beheren, die allemaal terug te vinden zijn de map vendor/ van de map MediaWiki.

Om deze benodigde bibliotheken te installeren, heeft u de volgende keuze:

• Download en installeer de composer PHAR, optioneel hernoem het composer.phar bestand zoals opgegeven voor uw OS, en voer dan composer update --no-dev uit vanuit de map MediaWiki. Dit is de aanbevolen aanpak.
  • Indien de standaard PHP CLI versie niet overeenkomt met de PHP-versie van de webserver, specificeer die dan met bijvoorbeeld php7.4 composer.phar update --no-dev.
• Of, indien u Composer niet wenst te gebruiken of exact dezelfde verzameling vendor-bibliotheken wil gebruiken zoals op de WMF productiecluster, kunt u in plaats $git om een vendor/ map aan te maken binnen de core map van uw MediaWiki installatie.
  git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
  • Merk op dat indien er ook maar één van u extensies zijn eigen Composer vereisten heeft u deze optie niet kunt gebruiken.

Voor MediaWiki 1.25, werden externe bibliotheken in de core repository verzameld, en was een package beheerder niet vereist.

Bijgewerkt houden

Indien u een specifieke branch of de ontwikkelaarsversie ("master" branch) gebruikt van MediaWiki, dan is de laatste wijzigingen oppikken vrij eenvoudig. Navigeer naar uw MediaWiki kloon map en voer dit commando uit:

git pull

Alle laatste wijzigingen voor de branch die u gebruikt, zullen toegepast worden.

De nieuwe versie van core kan nieuwere versies van extensies en thema's vereisen, u dient elke extensie en thema map na te kijken en deze bij te werken met een commando als git pull --recurse-submodules.

U dient ook vendor/ bij te werken met elke nieuwere versie van de vereiste bibliotheken. Dit betekent vaak het volgende Composer commando uitvoeren, maar zie #Externe bibliotheken ophalen hierboven voor meer details:

composer update --no-dev

Na het bijwerken/opwaarderen van de code en de vereiste bibliotheken kunt u best het MediaWiki update.php commandoregel script uitvoeren om database tabellen bij te werken waar nodig:

php maintenance/run.php update

Indien u MediaWiki-Vagrant/nl gebruikt, deze biedt één enkel commando, vagrant git-update, die al deze stappen uitvoert.

Naar andere versie veranderen

Elke van uw versies worden opgevolgd als branches of tags. Om te veranderen naar één van deze, dient u enkel de specifieke branch of tag die u wenst uit te checken uit de MediaWiki kloon map:

git checkout <branch-naam>

of

git checkout <labelnaam>

De wijzigingen zullen automatisch toegepast worden en u bent helemaal klaar.

Git gebruiken om MediaWiki extensies te downloaden

Lijst van extensies in git

Download een extensie

‎<EXT> dient vervangen te worden door de naam van de extensie die u wilt downloaden, zonder spaties. Voor Extension:TitleKey , zou dit zijn TitleKey. (Hoofdlettergevoelig!)

Download en dupliceer een extensie van Git:

Gebruik met uw ontwikkel-account deze commando's om de master branch te krijgen:

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

Om een stabiele release-branch te klonen en te pakken, gebruik deze commando's:

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

U kunt de extensie broncode bekijken in de Gerrit's gitiles applicatie en via de URL:

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/HEAD

Download alle extensies

Indien u verkiest om alleMediaWiki extensies die op gerrit.wikimedia.org staan uit te checken naar uw machine, voer het volgende in:

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

Of, om een stabiele releases branche te pakken (checkout), gebruik dit commando:

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

Na het uitvoeren van het commando git clone, ga verder met deze commando's:

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

Vul het volgende in om alle extensies naar de meest recente versie van die branch te updaten:

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

Om de veranderen naar een andere branch, zoals na een nieuwe release:

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

Onthoud dat u enkel versies van extensies hoort te gebruiken van dezelfde release als de versie van MediaWiki en elkaar.

Om de master branch op te volgen:

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

Merk op dat uw de master code niet dient te gebruiken in productie onder geen enkele voorwaarde omdat deze niet als stabiel wordt beschouwd.

Indien u een alleen-lezen checkout (bijvoorbeeld om een grep of analyse te doen van alle MediaWiki code), kunt u gedeelde MediaWiki checkout op Labs gebruiken, zonder iets te downloaden op uw machines.

Een extensie verwijderen

1. Verwijder de "require_once …" of "wfLoadExtension( … )" uit LocalSettings.php
2. Verwijder elke regel die verwijst naar de extensie in composer.local.json (meestal in de "extra → merge-plugin → include" sectie)
3. Verwijder de map van de extensie in install-dir/extensions/

Gebruik Git om MediaWiki skins te downloaden

Lijst van skins in git

MediaWiki 1.24 en later bevatten geen skins in de Git download.

Volg exact dezelfde procedure zoals voor extensies (beschreven in de vorige sectie), maar gebruik skins in plaats van extensions in alle URL's en paden.

Gedetailleerde instructies voor installatie zijn beschikbaar voor elk themapagina hier op MediaWiki.org, zie bijvoorbeeld Skin:Vector#Installation. Instructies voor alle andere thema's zijn analoog.

Zie ook

• Beknopte handleiding lokaal ontwikkelen

Appendix

Door de herziening per 14:26, 21 maart 2019 is de standaard voor het linken naar gerrit.wikimedia.org gewijzigd:

van:

gerrit.wikimedia.org/r/p/mediawiki

naar:

gerrit.wikimedia.org/r/mediawiki