Letöltés Gitről

A Git egy elosztott verziókövető szoftver. Lehetővé teszi a forráskód legfrissebb verziójának letöltését az összes ággal és felcímkézett kiadással.

Akkor töltsd le a MediaWikit Gitről, ha fejlesztő vagy, és szeretnél hibajavításokat beküldeni.

Ha nem szeretnél fejleszteni, csak telepítenéd a MediaWikit és a kiterjesztéseit, akkor inkább stabil tarballkiadásokat tölts le.

További részletekért lásd: Git, különösen, ha szeretnél hozzájárulni valamelyik projekthez. Alább néhány rövid útmutató látható a leggyakoribb feladatokhoz.

Előfeltételek

Először is telepítened kell a Gitet, mielőtt használni tudnád. Többféleképpen is beszerezheted a Gitet az operációs rendszeredtől függően. Kövesd a Git telepítéséről szóló útmutatónkat vagy használd a kedvenc keresődet.

Harmadik féltől származó könyvtárak letöltéséhez és telepítéséhez a Composer telepítése ajánlott, de nem kötelező.

Git használata a MediaWiki letöltéséhez

Letöltés

A Git használatával a MediaWiki-magot, valamint a Wikimédia Alapítvány szerverein telepített-, illetve azon kiterjesztéseket töltheted le, amelyek elérhetőek a gerrit segítségével.

Az első lépés a MediaWiki-mag tárolójának klónozása. Ez eltart egy ideig.

Letöltés fejlesztéshez

A MediaWiki legújabb fejlesztői változata a „master” ágon található.

Először is győződj meg róla, hogy rendelkezel fejlesztői fiókkal, így van SSH-felhasználóneved.

Ezt követően egy terminálablakban írd be a következő parancsot a tároló klónozásához:

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

A parancs a MediaWiki-mag master verzióját klónozza a mediawiki alkönyvtárba.

Más mappába való telepítéshez a parancsot kell módosítanod (további információt itt találhatsz). A tároló klónozása után átválthatsz különböző ágakra vagy címkékre. A master a MediaWiki fejlesztői változata, ezt ne használd éles helyzetben, mivel nem tekinthető stabilnak.

• A legfrissebb forráskód megtekintése

Stabil verzió letöltése

Ha nem fejleszteni szeretnél, hanem anonim módon klónozni a stabil kiadott ágat (1.42), használd a fentebbi helyett a következő parancsot:

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

Ha lassabb az internetkapcsolatod, a klónozott változatok számának csökkentéséhez add hozzá a --depth=1 parancsot a git clone parancshoz.

MediaWiki-címkék (stabil verzió)

A MediaWiki stabil verzióit a „címkék” tartalmazzák, amelyek a tarballokkal megegyeznek. Ezek jelenleg: 1.42.1 (stabil), 1.39.8 (hosszan támogatott – LTS), 1.39.8 (régebbi LTS)

Az összes címke megjelenítése:

git tag -l | sort -V

Egy bizonyos címke (például a legutóbbi stabil kiadás) használata:

git checkout 1.42.1

Git-almodulok letöltése

Az ágak és címkék számos, a kiterjesztésekhez és felületekhez, valamint a vendor/ könyvtárhoz használható Git-almodult tartalmaznak. A master ág nem tartalmazza ezeket. Az almodulok frissítéséhez futtasd a következő parancsokat:

cd mediawiki
git submodule update --init --recursive

Külső könyvtárak meghívása

A MediaWiki a külső PHP-könyvtárak kezeléséhez a Composert használja; ezeket a MediaWiki-telepítés vendor/ mappájában találhatod.

A szükséges könyvtárak többféleképpen telepíthetők:

• Töltsd le és telepítsd a Composer PHAR-t, opcionálisan nevezd át a composer.phar fájlt az operációs rendszeredre vonatkozó utasítások szerint, majd futtasd a composer update --no-dev parancsot a MediaWiki-könyvtáradból. Ez az ajánlott módszer.
  • Ha az alapértelmezett PHP CLI-verzió nem egyezik meg a webszerver PHP-verziójával, add meg pl. a php7.4 composer.phar update --no-dev paranccsal.
• Vagy, ha nem szeretnéd a Composer-t használni, vagy pedig ugyanazt a fejlesztői könyvtárakat szeretnéd használni, amiket a WMF fejlesztői fürtjében, akkor ehelyett létrehozhatod a vendor/ mappát a MediaWiki telepítésed fő mappájában:
  git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
  • Ha bármely kiterjesztésednek saját Composer-igénye van, nem használhatod ezt a módszert.

A MediaWiki 1.25 előtt a külső könyvtárak a központi tárhelyben voltak, és nem volt szükség csomagkezelőre.

Maradj naprakész

Ha egy bizonyos ágazatot, vagy a MediaWiki fejlesztői változatát ("master" ág) használod, akkor a legutóbbi változtatások felvétele viszonylag könnyű. Lépj a MediaWiki clone mappájába és futtasd ezt a parancsot:

git pull

A használt ág összes változtatása végrehajtódik.

A mag új verziója újabb bővitmény- vagy felületverziót igényelhet, tehát be kell lépned minden bővítmény és felület mappájába és frissítened kell őket egy olyan paranccsal, mint a git pull --recurse-submodules.

Frissítened kell a vendor/-t a szükséges könyvtárak újabb verziójával. Ez általában a következő Composer-parancs futtatását jelenti; további részletekért lásd a #Külső könyvtárak meghívása szakaszt:

composer update --no-dev

A kódváltozást követően futtasd az update.php parancssori szkriptet az adatbázis-táblák frissítéséhez.

php maintenance/run.php update

A MediaWiki-Vagrant használata esetén elég a vagrant git-update parancsot futttatni, amely az összes fenti lépést elvégzi.

Verzióváltás

Minden verziónk ágakkal vagy címkékkel vannak követve. Ahhoz, hogy másik verzióra válts (például a master ágról egy másik ágra vagy címkére), nézd meg azt a bizonyos ágat vagy címkét a Mediawiki klónkönyvtárából a checkout paranccsal:

git checkout <ág_neve>

vagy

git checkout <címke_neve>

A változtatások alkalmazása automatikus.

Kiterjesztések letöltése Gittel

Gitről elérhető kiterjesztések listája

Egy kiterjesztés letöltése

A következő parancsban cseréld ki a ‎<EXT> részt annak a bővítménynek a nevével, amit le akarsz tölteni, szóközök nélkül. Az Extension:TitleKey esetében ez TitleKey lenne. (Fontos a kis és nagybetű közti különbség!/Case sensitive!)

Kiterjesztés letöltése és klónozása:

A fejlesztői felhasználóval, használd ezeket a parancsokat a master ág eléréséhez:

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

A "clone", illetve a "checkout" esetén, használd ezeket a parancsokat:

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

A kiterjesztés forráskódját a Gerrit gitiles programjával és a következő URL-en tekintheted meg:

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

Az összes kiterjesztés letöltése

Ha a gerrit.wikimedia.org tárhelyen található minden MediaWiki-kiterjesztést le akarod tölteni, add ki a következő parancsokat:

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

Vagy, ha csak a "checkout" parancsot szeretnéd használni a kiadott ágaknál, használd ezt:

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

A git clone parancs futtatása után, folytasd ezekkel a parancsokkal:

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

Az összes kiterjesztésnek az adott ág legutóbbi verziójára való frissítéséhez ezt írd be:

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

Más ágra történő váltáskor, például új kiadás után:

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

Ne feledd, hogy csak ugyanazt a verziójú bűvítményt használd, mint a MediaWiki verziója.

A master ág követése:

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

Vedd figyelembe, hogy a master ág nem stabil, így éles használata ellenjavallt.

Ha csak egy olvasható változatra van szükséged (például az egész MediaWiki átvizsgálásánál vagy elemzésénél), használhatod a megosztott MediaWiki "checkout"-ot a Labs-en, anélkül, hogy letöltenél bármit is az eszközödre.

Kiterjesztések eltávolítása

1. Távolítsd el a „require_once …” vagy „wfLoadExtension( … )” sorokat a LocalSettings.php-ból
2. Távolíts el minden, a kiterjesztésre utaló sort a composer.local.json-ból (általában az „extra → merge-plugin → include” szakaszban található)
3. Távolítsd el a kiterjesztés könyvtárát a install-dir/extensions/ mappából

Felületek letöltése Gittel

Gitről elérhető felületek listája

A MediWiki 1.24-től kezdve a Gitről letöltött csomagokban nincsenek felületek.

Alkalmazd a kiterjesztéseknél leírt módszert, de az URL-ekben és fájlútvonalakban az extensions helyett a skins-t használd.

Részletes információk az egyes felületek leírólapján (például Felület:Vector#Telepítés) találhatóak. Az instrukciók minden felület esetén megegyeznek.

Függelék

A 2019. március 21.-ei 14:26-os átnézés megváltoztatta a gerrit.wikimedia.org linkek működését:

Erről:

gerrit.wikimedia.org/r/p/mediawiki

Erre:

gerrit.wikimedia.org/r/mediawiki