Download from Git/cs


 * Od MediaWiki verze 1.19beta2, 1.18.2, 1.17.3, se pro jádro MediaWiki a její rozšíření používá verzovací systém Git. Pro starší verze viz Subversion

Git je distribuovaný verzovací systém, který umožňuje uživatelům stahovat ty nejaktuálnější verze, aniž by museli čekat než se najde kdo by je zabalil. MediaWiki tak může mnohem rychleji vydávat nové verze, a pro vás je mnohem snazší vaši instalaci aktualizovat, vracet nežádoucí změny nebo dělat záplaty. (Pochopitelně pamatujte na to, že oficiální stabilní vydání sebou nesou mnohem méně rizika.)

Pro podorbnější informace vizte stránku Git, obzvláště, pokud se chcete sami stát přispěvateli. Níže popsané pokyny zmiňují pouze základní operace pro práci s repozitářem.

Výchozí předpoklady
Musíte mít především nainstalován Git. Jak to udělat, závisí na vašem operačním systému. Oficiální binární instalační balíčky a jeho zdrojový kód najdete na git-scm.com. Informace, jak ho nainstalovat na vámi používaný operační systém, si můžete vyhledat také prostřednictvím některého internetového vyhledávače.

Pro stahování a instalaci knihoven třetích stran se doporučuje mít nainstalován také composer, ale není to nutné.

Stažení
Aktuálně lze přes Git stáhnout nejenom jádro MediaWiki (na SVN větev phase3), ale i kterékoliv z rozšíření instalovaných na serverech clusteru Wikimedia Foundation.

Prvním krokem, který může nějakou chvíli trvat, je naklonování repozitáře MediaWiki.

Zadejte na vaší příkazové řádce následující příkaz: git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git

Pokud se vám vrátí chybová zpráva "The requested URL returned error: 403" nebo "error: The requested URL returned error: 403 while accessing https://gerrit.wikimedia.org/r/p/mediawiki/core.git", zkontrolujte jakou máte nainstalovanou verzi gitu git --version a je-li starší než 1.7, musíte provést aktualizaci, u verzí 1:1.7.2.3-2.2~bpo50+1,1.7.9.2 a 1.7.9.6 je ověřeno že fungují bez problému.

Je-li vše v pořádku, bude do podadresáře s názvem core naklonován celý repozitář jádra MediaWiki. Výchozí větví bude vývojová verze. Pouze pokud bude repozitář kompletně naklonován, budete moci přepínat mezi různými větvemi, nebo tagy (viz níže), včetně vydání stabilních verzí MediaWiki.

Stažení pro další vývoj
Pokud máte účet vývojáře (o který není problém požádat): git clone ssh:// @gerrit.wikimedia.org:29418/mediawiki/core.git



Stažení externích knihoven
Počínaje verzí 1.25, již nejsou některé externí knihovny, které MediaWiki používá, součástí git repozitáře "core". Pro jejich správu používáme composer. Pro instalaci těchto knihoven tedy musíte:


 * Stáhnout a doinstalovat composer, skočit do "core" adresáře a pak spustit . Pozor, pokud již soubor   existuje, pak místo instalace musíte spustit.


 * Nechcete-li používat composer, nebo pokud chcete používat zcela identickou sadu knihoven, se kterou pracuje produkční cluster WMF, tak můžete použít  a stažený obsah repozitáře umístit do adresáře   v kořeni instalace vaší MediaWiki.

WMF větve
Tyto větve sledují verze MediaWiki používané na strojích clusteru Wikimedia Foundation. Ty nemusí být zcela bez chyb, ale rychle se opravují a konec konců je lze pokládat za dostatečně stabilní – když je používá takový projekt, jako je Wikipedia. Je-li větev považováná za dostatečně 'stabilní', pak je z ní vytvořena větev s názvem začínajícím REL*, 'otagována'' a zabalena do tarbalu.

Chcete-li vidět, jaké větve jsou k dispozici, skočte do vašeko klonu MediaWiki a spusťte následující příkaz: git branch -r | sort -V Hlavní vydání jsou vidět jako "origin/REL ", např. "origin/". Pro přepnutí na tyto větve musíte udělat: git checkout -b REL origin/REL Například pro přepnutí na aktuální stabilní verzi, zadejte: git checkout -b origin/

Značkování MediaWiki (stabilní verze)
Dalším způsobem, jak se dostat ke stabilní verzi MediaWiki je využít značky. Ty odpovídají vydáním, ze kterých se dělají tarbally. Jaké verze jsou dostupné lze vypsat takto: git tag -l | sort -V Pokud používáte jinou než GNU verzi příkazu sort, jako je kupř. na Mac OS X, pak musíte pamatovat na staré dobré oddělovače: git tag -l | sort -n -t. -k1 -k2 -k3

Přepnutí s využitím značky: git checkout

Aktuální vývojová verze MediaWiki
Aktuální vývojová verze MediaWiki je na větvi 'master'. To je ta, na kterou se dostanete při naklonování repozitáře MediaWiki. Pokud jste se mezitím přepnuli na jinou větev, pak se k ní můžete snadno přepnout zpět pokud uděláte: git checkout master

Aktualizace
Pokud jste použili nějakou dílčí větev, nebo vývojovou verzi MediaWiki, je aplikace posledních změn opravdu jednoduchá. Přejděte do vašeho adresáře s naklonovanou MediaWiki a spusťte příkaz pull: git pull Tím se na vaši větev aplikují veškeré změny, které ve větvi proběhly od jejího naklonování.

Po aktualizaci musíte ještě na příkazovém řádku spustit aktualizační skript: php maintenance/update.php

Přepnutí na jinou verzi
Přepnutí na jinou verzi MediaWiki je u Gitu mnohem rychlejší a jednodušší než u SVN. Každá verze je uložena v samostatné větvi a označkovaná. Chcete-li přepnout na některou z nich, pak jediné co potřebujete udělat, je 'checkout' na příslušnou větev, nebo značku ve vašem adresáři s naklonovaným repozitářem MediaWiki: git checkout nebo git checkout Veškeré změny v souborech se automaticky provedou a vše budete mít ihned k dispozici jak má být.

Stažení

 * Seznam rozšíření v git repozitáři
 *  musíte nahradit názvem rozšíření, které chcete stáhnout. Kupř. pro Extension:TitleKey, použijte TitleKey. (pozor na velikost písmen!)

Stažení a klonování rozšíření z Git repozitáře:

cd /path/to/extensions git clone https: //gerrit.wikimedia.org/r/p/mediawiki/extensions/.git

Vývojáři klonují takto: git clone ssh:// @gerrit.wikimedia.org:29418/mediawiki/extensions/.git Prohlížet si můžete zdrojový kód takto:

https://gerrit.wikimedia.org/r/gitweb?p=mediawiki/extensions/.git;a=tree;h=refs/heads/master;hb=master

Stažení všech rozšíření
Pokud chcete mít k dispozici všechna rozšíření MediaWiki, která jsou na gerrit.wikimedia.org pak proveďte následující:

git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions.git cd extensions git submodule update --init --recursive

Pro aktualizaci rozšíření na jejich poslední verzi musíte udělat toto:

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

Pro sledování vybrané větve: git submodule foreach 'git checkout -b REL1_24 origin/REL1_24 || :'

Použití Gitu ke stažení grafických témat pro MediaWiki
Od MediaWiki 1.24 již nejsou grafická témata, která zajišťují vzhled wiki stránek součástí Git repozitáře "core".

Stažení
git clone https://gerrit.wikimedia.org/r/p/mediawiki/skins.git

Přejděte do naklonovaného adresáře skins. A pro stažení všech grafických témat použijte:

git submodule update --init --recursive

Pro integraci zvoleného grafického tématu přidejte do vašeho souboru řádek  :
 * (Je to stejné, jako když se dělá instalace rozšíření, jen s tím rozdílem, že cesta vede do jiného podadresáře.)
 * (Je to stejné, jako když se dělá instalace rozšíření, jen s tím rozdílem, že cesta vede do jiného podadresáře.)

Podrobný postup instalace grafického tématu můžete najít na stránkách MediaWiki.org, viz kupř. Skin:Vector#Instalace. Stejný postup platí i pro jiná témata.

Viz též

 * Migrace z SVN na Git
 * Noční balík, je alternativou k aktuálnímu Git repozitáři.