Git ar ett distribuerat versionshanteringssystem . Den mojliggor att anvandare laddar ned den absolut senaste versionen av kallkoden , med alla grenar och tillgangliga taggade versioner.

Du bor ladda ner fran Git om du ar en utvecklare och vill skicka in patchar .

Om du inte vill utveckla utan bara installera MediaWiki och tillagg bor du ladda ner stabila tarball-versioner istallet.

Se Git for fler detaljer, speciellt nar det handlar om att bidra. Nedan finns nagra kortfattade instruktioner for ofta forekommande uppgifter.

Du maste ha Git installerat innan du kan anvanda det. Det finns manga olika satta att installera Git, beroende pa ditt operativsystem. Folj Gerrit/Tutorial#Set up Git , eller anvand en sokmotor.

Det rekommenderas att du har Composer installerat for att ladda ner och installera tredjepartsbibliotek, men det ar inget krav.

Ladda ned

Du kan ladda ner MediaWiki bas med Git, och aven alla tillagg for narvarande installerade i Wikimediastiftelsens serverkluster och manga andra tillagg tillgangliga pa Gerrit .

Det forsta steget ar att klona MediaWiki core-arkivet. Detta kan ta ett tag.

Ladda ner for utveckling

Den senaste utvecklingsversionen av MediaWiki finns i "master"-grenen.

Se forst till att du har skapat ett utvecklarkonto , sa att du har ett ssh-anvandarnamn.

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

Detta klonar hela MediaWiki core repository, synkroniserat med mastergrenen, till en underkatalog som heter mediawiki .

Om du vill installera i en annan katalog andrar du det pa kommandoraden (for mer information hanvisar till den har dokumentationen ). Nar forradet har klonats kan du vaxla till olika grenar eller taggar . Utvecklingsgrenen, master , ar den senaste utvecklarversionen av MediaWiki; du bor inte anvanda master code for produktion under alla omstandigheter, eftersom den inte kan anses stabil.

• Visa senaste kallkoden

Ladda ner stabila grenen

Om du inte vill utveckla programvarupatchar utan vill klona den stabila utgivningsgrenen 1.41 anonymt, anvand da det har kommandot istallet:

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

Om du har en langsam internetanslutning och vill minska antalet revisioner som klonas kan du lagga till --depth=1 till kommandot git clone .

MediaWiki-taggar (stabil version)

Alternativt kan specifika stabila versioner av MediaWiki sparas med hjalp av "taggar". Dessa ar analoga med tarballutgavorna. Just nu ar dessa 1.41.1 (stabil), 1.39.7 ( LTS ) och 1.39.7 (legacy LTS).

Du kan se alla tillgangliga taggar med:

git
 tag
 -l
 |
 sort
 -V

For att anvanda en specifik tagg, t.ex. den senaste stabila utgavan:

git
 checkout
 1
.41.1

Uppdatera Git-submodulerna

Grenarna och taggarna har ett antal Git-submoduler for vanligt forekommande tillagg och utseenden och for vendor/ -katalogen. Grenen master har inte dessa. For att uppdatera undermodulerna, kor:

cd
 mediawiki
git
 submodule
 update
 --init
 --recursive

Hamta externa bibliotek

MediaWiki anvander Composer for att hantera externa PHP-bibliotek, som alla hamnar i katalogen vendor/ i din MediaWiki-katalog.

For att installera de kravda biblioteken sa har du valet:

• Ladda ner och installera composer PHAR , byt eventuellt namn pa filen composer.phar enligt instruktionerna for ditt operativsystem och kor sedan composer update --no-dev fran din MediaWiki-katalog. Detta ar det rekommenderade tillvagagangssattet.
  • Om standardversionen av PHP CLI inte matchar webbserverns PHP-versionen, anger du det med t.ex. php7.4 composer.phar update --no-dev .
• Om du inte vill anvanda Composer eller om du vill anvanda exakt samma uppsattning leverantorsbibliotek som anvands i WMF-produktionsklustret kan du istallet skapa en vendor/ -katalog i karnmappen i din MediaWiki-installation:
  git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
  • Notera att om nagot av dina tillagg har sina egna Composer-krav sa kan du inte anvanda detta valet .

Fore MediaWiki 1.25 forvarades externa bibliotek i karnkodforradet och ingen pakethanterare behovdes.

Hall dig uppdaterad

Om du anvander en viss gren eller utvecklingsversionen ("master"-grenen) av MediaWiki ar det relativt enkelt att hamta de senaste andringarna. Byt till katalogen med din MediaWiki-klon och kor det har kommandot:

git
 pull

Alla de senaste andringarna for grenen du anvander kommer appliceras.

Den nya versionen av core kan krava nyare versioner av tillagg och utseenden, sa du maste ga in i varje tillaggs- och utseendekatalog och uppdatera den med ett kommando som git pull --recurse-submodules .

Du maste ocksa uppdatera vendor/ med nagon senare version av de nodvandiga biblioteken. Detta innebar ofta att du behover kora foljande Composerkommando, men las #Hamta externa bibliotek ovanfor for mer detaljer:

composer
 update
 --no-dev

Efter att ha uppdaterat/uppgraderat koden och de nodvandiga biblioteken bor du kora kommandoradsskriptet MediaWiki update.php for att uppdatera databastabellerna:

php
 maintenance/update.php

Om du anvander MediaWiki-Vagrant , erbjuder det ett enkelt kommande, vagrant git-update , som utfor alla dessa steg.

Att byta till en annan version

Alla vara versioner sparas som grenar eller taggar. For att byta mellan olika versioner (till exempel fran grenen master till en annan gren eller tagg), kolla upp den specifika grenen eller tagg du vill ha fran MediaWikis klonforvar:

git
 checkout
 <gren_namn>

eller

git
 checkout
 <tagg_namn>

Andringarna kommer automatiskt tillampas och du ar klar att kora.

Lista over tillagg i git

Ladda ned ett tillagg

I de kommande kommandona, ersatt Extension:TitleKey med namnet pa tillagget du vill ladda ner, utan mellanslag. For Extension:TitleKey , skulle det bli TitleKey. (skifteslageskansligt!)

Ladda ner och klona ett tillagg fran Git:

With your developer account, use these commands to get the master branch:

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

To clone and checkout a stable release branch instead, use these commands:

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

Du kan lasa tillaggs kallkod pa applikationen Gerrit's gitiles , och pa webbadressen:

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

Ladda ned alla tillagg

Om du foredrar att kontrollera alla MediaWiki-tillagg som finns pa gerrit.wikimedia.org pa din maskin, skriv in foljande:

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

Or, to checkout stable releases branch instead, use this command:

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

After running the git clone command, continue with these commands:

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

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

git
 submodule
 foreach
 'git checkout -b REL1_40 origin/REL1_40 ||?:'

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

Ta bort ett tillagg

1. Ta bort " require_once … " eller " wfLoadExtension( … ) " fran LocalSettings.php
2. Ta bort alla rader som refererar till tillagget i composer.local.json (oftast i avsnittet "extra → merge-plugin → include")
3. Ta bort tillaggets katalog i install-dir/extensions/

Lista over utseenden i git

MediaWiki 1.24 och senare inkluderar inte utseenden i Git-nedladdningen.

Folj exakt samma process som for tillagg (beskrivet i en tidigare sektion), men anvand skins istallet for extensions i alla webbadresser och sokvagar.

Detaljerade installationsinstruktioner finns pa varje utseendes sida har pa MediaWiki.org, till exempel Skin:Vector#Installation . Instruktioner for alla andra utseenden ar liktydiga.

• Intranet/Intranet-installering , del av en fullarbetad serie artiklar som anvander Git for att rulla ut MediaWiki

The Revision as of 14:26, 21 March 2019 changed the standard of linking to gerrit.wikimedia.org:

from:

gerrit.wikimedia.org/r/ p /mediawiki

to:

gerrit.wikimedia.org/r/mediawiki