Stažení z Gitu

This page is a translated version of the page Download from Git and the translation is 100% complete.

Git je Distribuovaný systém pro správu verzí. Umožňuje vám stiahnuť najnovšiu verziu zdrojového kódu, so všetkými vetvami a označenými vydaniami, ktoré sú k dispozícii.

Ak ste vývojár a chcete riešiť záplaty, mali by ste si ich stiahnuť z Gitu.

Ak nechcete vyvíjať, ale len inštalovať MediaWiki a rozšírenia, potom si sťahujte stabilnú tarball verziu.

Pre podrobnejšie informácie sa pozrite na stránku Git. Najmä, ak sa chcete sami stať prispievateľmi. Nižšie popísané pokyny spomínajú iba základné operácie pre prácu s dátovým úložiskom.

Predpoklady

Než ho budete môcť používať, musíte mať nainštalovaný Git. Existuje mnoho spôsobov, ako, v závislosti na vašom operačnom systéme, Git získať. Postupujte podľa Gerrit/Návodu#Nastavenia Gitu alebo použite svoj obľúbený vyhľadávač.

Pre sťahovanie a inštaláciu knižníc tretích strán sa odporúča mať nainštalovaný aj Composer . Nutné to ale nie je.

Stiahnutie MediaWiki cez Git

Stiahnutie

Jadro MediaWiki si môžete stiahnuť pomocou Gitu, rovnako ako všetky rozšírenia aktuálne nainštalované na serveroch Wikimedia Foundation. Na gerrit je tiež k dispozícii mnoho ďalších rozšírení.

Prvým krokom je naklonovanie základného úložiska MediaWiki. Bude to chvíľu trvať.

Stiahnutie pre ďalší vývoj

Aktuálna vývojová verzia MediaWiki je na vetve 'master'.

Aby ste získali užívateľské meno SSH, najprv sa uistite, že ste si vytvorili účet vývojára.

Potom na klonovanie úložiska v okne terminálu zadajte nasledujúci príkaz:

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

Tým sa klonuje celé jadro úložiska MediaWiki, synchronizované s hlavnou vetvou, do podadresára s názvom mediawiki.

Ak chcete inštalovať do iného adresára, zmeňte ho v príkazovom riadku (ďalšie informácie nájdete v tejto dokumentácii). Akonáhle je úložisko klonované, môžete prepínať na rôzne vetvy alebo označenia. Vývojová vetva, master, je špičková vývojárska verzia MediaWiki. Za žiadnych okolností by ste nemali používať master kód pre tvorbu, pretože nie je považovaný za stabilný.

Zobraziť poslednú verziu zdrojového kódu

Stiahnite si stabilnú vetvu

Ak nechcete vyvíjať softvérové záplaty, ale chcete anonymne klonovať stabilnú vetvu 1.42, použite tento príkaz:

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

Ak máte pomalé pripojenie k internetu a chcete znížiť počet klonovaných revízií, pridajte do príkazu git clone --depth=1.

Označenie MediaWiki (stabilná verzia)

Ďalším spôsobom, ako sa dostať k stabilnej verzii MediaWiki je využiť 'označenia' (tags). Tie zodpovedajú vydaniam, z ktorých sa robia tarbally. V súčasnej dobe sw ide o 1.42.4 (stabilný), 1.39.11 (LTS) a 1.39.11 (starší LTS).

Všetky dostupné označenia môžete zobraziť pomocou:

git tag -l | sort -V

Prepnutie s využitím označenia, napr. najnovšia stabilná verzia:

git checkout 1.42.4

Aktualizujte submoduly Gitu

Vetvy a značky obsahujú skupinu submodulov Gitu pre bežne používané rozšírenia a vzhľady a pre adresár vendor/. Vetva master ich nemá. Ak chcete aktualizovať submoduly, spustite:

cd mediawiki
git submodule update --init --recursive

Stiahnutie externých knižníc

MediaWiki používa Composer na správu externých knižníc PHP. Všetky z nich končia v adresári vendor/ vo vašom adresári MediaWiki.

Pre inštaláciu týchto knižníc máte na výber:

Stiahnite si a nainštalujte composer PHAR, prípadne premenujte súbor Composer.phar podľa pokynov pre váš operačný systém a potom spustite composer update --no-dev z adresára MediaWiki. Toto je odporúčaný prístup.
- Ak predvolená verzia PHP CLI nezodpovedá verzii PHP webového servera, zadajte ju napr. php7.4 composer.phar update --no-dev.
Alebo ak nechcete použiť Composer alebo ak chcete použiť presne rovnakú sadu knižníc dodávateľov, aká bola použitá v produkčnom klastri WMF, môžete namiesto toho vytvoriť adresár vendor/ vo vnútri hlavného priečinka inštalácie MediaWiki:
git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
- Ak niektoré z vašich rozšírení majú svoje vlastné požiadavky na Composer, nemôžete túto možnosť použiť.

Pred verziou MediaWiki 1.25 boli externé knižnice uchovávané v hlavnom úložisku a nebol požadovaný žiadny správca súborov.

Priebežná aktualizácia

Ak ste použili nejakú čiastkovú vetvu alebo vývojovú verziu ("master" vetvu) MediaWiki, je aplikácia posledných zmien relatívne jednoduchá. Prejdite do vášho adresára s naklonovanou MediaWiki a spustite tento príkaz:

git pull

Tým sa na vašu vetvu aplikujú všetky zmeny, ktoré vo vetve prebehli od jej naklonovania.

Nová verzia jadra môže vyžadovať novšie verzie rozšírenia a zobrazenia, takže musíte ísť do každého adresára rozšírenia a zobrazenia a aktualizovať ho príkazom git pull --recurse-submodules.

S novšími verziami požadovaných knižníc musíte tiež aktualizovať vendor/. Často to znamená aj spustenie nasledujúceho príkazu Composera. Ďalšie podrobnosti nájdete v #Fetch externej knižnice vyššie:

composer update --no-dev

Po aktualizácii/ vylepšení kódu a požadovaných knižníc musíte ešte v príkazovom riadku spustiť skript update.php , aby boli podľa nových potrieb zaktualizované aj databázové tabuľky:

php maintenance/run.php update

Ak používate MediaWiki-Vagrant , je v ponuke aj jediný príkaz vagrant git-update, ktorým sa vykonajú všetky tieto kroky naraz.

Prepnutie na inú verziu

Každá z našich verzií je sledovaná ako vetva alebo označenie. Ak chcete prepnúť na inú verziu (napríklad z vetvy master na inú vetvu alebo označenie), prekontrolujte konkrétnu vetvu alebo označenie, ktoré chcete získať z vášho adresára klonov MediaWiki:

git checkout <názov_vetvy>

alebo

git checkout <názov_značky>

Všetky zmeny v súboroch sa vykonajú automaticky a všetko budete mať ihneď k dispozícii.

Použitie Gitu na stiahnutie rozšírenia MediaWiki

Zoznam rozšírení na Gitu

Stiahnutie rozšírenia

V ďalších príkazoch nahraďte ‎<EXT> bez medzier názvom rozšírenia, ktoré chcete stiahnuť. Za Extension:TitleKey by to mohlo byť TitleKey. (Zápis je citlivý na veľkosť písmen!)

Stiahnutie a klonovanie rozšírenia z Git repozitára:

Cez účet vývojára získate hlavnú vetvu pomocou týchto príkazov:

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

Ak chcete namiesto toho klonovať a rezervovať vetvu stabilného vydania, použite tieto príkazy:

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

Zdrojový kód rozšírenia si môžete pozrieť v aplikácii Gerrit's gitiles a na adrese URL:

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

Stiahnutie všetkých rozšírení

Pokiaľ chcete mať k dispozícii všetky rozšírenia MediaWiki, ktoré sú na gerrit.wikimedia.org, potom vložte nasledujúce:

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

Alebo ak chcete namiesto toho skontrolovať vetvu stabilných verzií, použite tento príkaz:

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

Po spustení príkazu git clone pokračujte týmito príkazmi:

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

Ak chcete kedykoľvek aktualizovať všetky rozšírenia na najnovšie verzie tejto vetvy, zadajte:

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

Pre zmenu na inú vetvu, napríklad po vydaní novej verzie:

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

Nezabudnite, že by ste mali používať iba verzie rozšírenia z rovnakého vydania ako je táto verzia MediaWiki.

Pre sledovanie hlavnej vetvy (master):

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

Vezmite prosím na vedomie, že za žiadnych okolností by ste nemali používať master kód pre tvorbu, pretože nie je považovaný za stabilný.

Ak potrebujete výstup iba na čítanie (napríklad pre grep alebo analýzu celého kódu MediaWiki), môžete, bez toho, aby ste si na svoj počítač čokoľvek sťahovali, použiť zdieľaný výstup MediaWiki.

Odstránenie rozšírenia

Odstráňte "require_once …" alebo "wfLoadExtension( … )" z LocalSettings.php
Odoberte akýkoľvek riadok odkazujúci na rozšírenie v composer.local.json (obvykle v sekcii "extra → merge-plugin → include").
Odstráňte adresár rozšírenia v install-dir/extensions/.

Na stiahnutie zobrazenia MediaWiki použite Git

Zoznam zobrazení v Gite

MediaWiki verzia 1.24 a novšia neobsahujú zobrazenie do sťahovania Gitu.

Postupujte presne podľa rovnakých krokov ako pri rozšíreniach (popísaných v predchádzajúcej časti). Vo všetkých adresách URL a cestách používajte radšej skins ako extensions.

Podrobné pokyny pre inštaláciu sú k dispozícii na stránke každého zobrazenia tu na MediaWiki.org, napríklad pozri Zobrazenie:Vector#Installation. Pokyny pre všetky ostatné vzhľady sú analogické.

Pozri aj

Doplnenie

Revízia zo 14:26, 21. marca 2019 zmenila štandard odkazovania na gerrit.wikimedia.org:

z:

gerrit.wikimedia.org/r/p/mediawiki

na:

gerrit.wikimedia.org/r/mediawiki