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ž je někdo zabalí. MediaWiki tak může mnohem rychleji vydávat nové verze. Pro vás je tak 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 podrobnější informace se podívejte na stránku Git. Zejména, 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í
Jádro MediaWiki si můžete stáhnout pomocí Gitu, stejně jako všechna rozšíření aktuálně nainstalovaná v klastru serveru Wikimedia Foundation a mnoho dalších rozšíření hostovaných na u.

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

Do okna terminálu zadejte následující příkaz:

Tím se naklonuje celé jádro úložiště MediaWiki, původně zaměřené na verzi, do podadresáře s názvem.

Chcete-li instalovat do jiného adresáře, změňte jej v příkazovém řádku (další informace naleznete v těchto dokumentech). Jakmile je úložiště klonováno, můžete snadno přepnout na různé verze nebo značky (viz níže), včetně těch, které sledují nestabilní verze MediaWiki. Vývojová verze,, je špičkovou vývojářskou verzí MediaWiki; neměli byste používat hlavní kód pro výrobu za žádných okolností, protože to není považováno za stabilní.

Pokud chcete snížit počet klonovaných revizí, přidejte do výše uvedeného příkazu.

Verze vydání mají v sobě spoustu Git submodulů, pro běžně používaná rozšíření a vzhledy (hlavní verze tyto nemá). Chcete-li aktualizovat dílčí moduly, spusťte:

Stažení pro další vývoj
Pokud máte účet vývojáře (o který není problém požádat), měli byste místo klonování anonymně pomocí https klonovat pomocí ssh , abyste mohli odeslat změny ke kontrole:

Tím se klonuje celé jádro úložiště MediaWiki, synchronizované s hlavní větví, do podadresáře s názvem.



Stažení externích knihoven
MediaWiki používá Composer ke správě externích knihoven PHP, z nichž všechny končí v adresáři  ve vašem adresáři MediaWiki.

Pro instalaci těchto knihoven máte na výběr:


 * [$url- Download and install the composer PHAR] stáhněte a nainstalujte skladatele PHAR, případně přejmenujte soubor Composer.phar podle pokynů pro váš operační systém a poté spusťte  z adresáře MediaWiki. Toto je doporučený přístup.
 * 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. Pokud některá z vašich rozšíření mají své vlastní požadavky na skladatele, nemůžete tuto možnost použít.

Před MediaWiki 1.25 byly externí knihovny uchovávány v hlavním úložišti a nebyl vyžadován žádný správce souborů.

Značkování MediaWiki (stabilní verze)
Dalším způsobem, jak se dostat ke stabilní verzi MediaWiki je využít 'značky' (tags). Ty odpovídají vydáním, ze kterých se dělají tarbally. V současné době sw jedná o (stabilní),  (LTS) a  (starší).

Všechny dostupné značky můžete zobrazit pomocí:

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:

Přepnutí s využitím značky, např. nejnovější stabilní verze:

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:

Průběžná aktualizace
Pokud jste použili nějakou dílčí větev, nebo vývojovou verzi („master“ větev) MediaWiki, je aplikace posledních změn relativně jednoduchá. Přejděte do vašeho adresáře s naklonovanou MediaWiki a spusťte tento příkaz:

Tím se na vaši větev aplikují veškeré změny, které ve větvi proběhly od jejího naklonování.

Nová verze jádra může vyžadovat novější verze rozšíření a vzhledů, takže musíte jít do každého adresáře rozšíření a vzhledu a aktualizovat jej příkazem.

Také musíte aktualizovat  s novějšími verzemi požadovaných knihoven. To často znamená spuštění následujícího příkazu Composer. Další podrobnosti viz #Fetch externí knihovny výše:

Po aktualizaci/upgradu kódu a požadovaných knihoven musíte ještě v příkazovém řádku spustit  script, aby byly podle potřeby aktualizovány databázové tabulky:

Pokud používáte MediaWiki-Vagrant, nabízí jediný příkaz, který provede všechny tyto kroky.

Přepnutí na jinou verzi
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:

nebo

Veškeré změny v souborech se provedou automaticky a vše budete mít v pořádku ihned k dispozici.

Použití Gitu ke stažení rozšíření MediaWiki

 * Seznam rozšíření na gitu

Stažení rozšíření

 *  musíte nahradit názvem rozšíření, které chcete stáhnout. Kupř. pro, použijte TitleKey. (Pozor na velikost písmen!)

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

Vývojáři klonují takto:

Zdrojový kód rozšíření si můžete prohlédnout v aplikaci Gerrit's gitiles a na adrese URL:

 https://gerrit.wikimedia.org/g/mediawiki/extensions//+/refs/heads/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 vložte následující:

Pro aktualizaci všech rozšíření na jejich poslední verzi dané větve pak musíte zadat:

Pro změnu na jinou větev, například po vydání nové verze:

Nezapomeňte, že byste měli používat pouze verze rozšíření ze stejného vydání jako tato verze MediaWiki a navzájem.

Pro sledování hlavní větve (master):

Vezměte prosím na vědomí, že byste neměli pro provoz za žádných okolností používat hlavní kód. Není to považováno za stabilní.

Pokud potřebujete pouze pokladnu jen pro čtení (například pro grep nebo analýzu celého kódu MediaWiki), můžete použít sdílený poklad MediaWiki v laboratořích, aniž byste si na své počítače stahovali cokoli.

Odstranění rozšíření

 * 1) Odstraňte " " nebo " " z
 * 2) Odebrat jakýkoli řádek odkazující na rozšíření v   (obvykle v sekci "extra → merge-plugin → include")
 * 3) Odstraňte adresář rozšíření v

Použití Gitu ke stažení grafických témat pro MediaWiki

 * Seznam témat na Gitu

MediaWiki 1.24 a novější nezahrnují skiny do stahování Git.

Postupujte přesně podle stejného postupu jako u rozšíření (popsaných v předchozí části), ale ve všech adresách URL a cestách používejte spíše  než.

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.
 * Intranet / intranetová instalace - část plně propracované řady článků, které používají nasazení Git pro MediaWiki