Download from Git/cs

Git je distribuovaný systém pro správu verzí. Umožňuje vám stáhnout nejnovější verzi zdrojového kódu, se všemi větvemi a označenými vydáními, které jsou k dispozici.

Pokud jste vývojář a chcete řešit záplaty, měli byste si je stáhnout z Gitu.

Pokud nechcete vyvíjet, ale pouze instalovat MediaWiki a rozšíření, pak si stahujte stabilní tarball verze.

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 datovým uložištěm.

Předpoklady
Než jej budete moci používat, musíte mít nainstalovaný Git. Existuje mnoho způsobů, jak, v závislosti na vašem operačním systému, získat Git. Postupujte podle Gerrit/Návodu#Nastavení Gitu nebo použijte svůj oblíbený vyhledávač.

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

Stažení
Jádro MediaWiki si můžete stáhnout pomocí Gitu, stejně jako všechna rozšíření aktuálně nainstalovaná na serverech Wikimedia Foundation. Na je také k dispozici mnoho dalších rozšíření.

Prvním krokem je naklonování základního úložiště MediaWiki. To bude chvíli trvat.

Stažení pro další vývoj
Aktuální vývojová verze MediaWiki je na větvi 'master'.

Nejprve se ujistěte, že jste vytvořili účet vývojáře, abyste získali uživatelské jméno ssh.

Poté v okně terminálu zadejte následující příkaz pro klonování s vaším ssh, abyste mohli odeslat opravy ke kontrole:

Tím se klonuje celé jádro úložiště MediaWiki, synchronizované s hlavní větví, 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éto dokumentaci). Jakmile je úložiště klonováno, můžete přepnout na různé větve nebo označení. Vývojová větev,, je špičková vývojářská verze MediaWiki.Za žádných okolností by jste neměli používat master kód pro tvorbu, protože není považován za stabilní.



Stáhněte si stabilní větev
Pokud nechcete vyvíjet softwarové záplaty, ale chcete anonymně klonovat stabilní větev, použijte tento příkaz:

Pokud máte pomalé připojení k internetu a chcete snížit počet klonovaných revizí, přidejte do příkazu.

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

Všechna dostupná označení můžete zobrazit pomocí:

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

Aktualizujte submoduly Gitu
Větve mají v sobě množství submodulů Gitu, pro běžně používaná rozšíření a zobrazení (hlavní větev je nemá). Chcete-li aktualizovat dílčí moduly, spusťte:

Stažení externích knihoven
MediaWiki používá 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:


 * Stáhněte si a nainstalujte composer 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.
 * Nebo pokud nechcete použít Composer nebo pokud chcete použít přesně stejnou sadu knihoven dodavatelů, jaká byla použita v produkčním klastru WMF, můžete místo toho vytvořit adresář  uvnitř hlavní složky instalace MediaWiki:
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * Pokud některá z vašich rozšíření mají své vlastní požadavky na Composer, nemůžete tuto možnost použít.

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

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 zobrazení, takže musíte jít do každého adresáře rozšíření a zobrazení 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 Composeru. Další podrobnosti viz #Fetch externí knihovny výše:

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

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

Přepnutí na jinou verzi
Každá z našich verzí je sledována jako větev nebo označení. Chcete-li přepnout na jinou verzi (například z větve  na jinou větev nebo označení),  konkrétní větev nebo označení, kterou chcete získat z vašeho adresáře klonů 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í

 * V dalších příkazech nahraďte názvem přípony, kterou chcete stáhnout, bez mezer. Za  by to byla TitleKey. (citlivé na velká písmena!)

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

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

For anonymous checkout of the stable branch instead, use these commands:

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í:

With your developer account, to get the master branch:

For anonymous checkout of the stable branch instead, use this command:

After running the  command, continue with these commands:

Chcete-li kdykoli aktualizovat všechna rozšíření na nejnovější verze této větve, zadejte:

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.

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 výstup pouze pro čtení (například pro grep nebo analýzu celého kódu MediaWiki), můžete použít sdílený výstup MediaWiki, aniž byste si na své počítače cokoli stahovali.

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éž

 * Intranet / intranetová instalace - část plně propracované řady článků, které používají nasazení Git pro MediaWiki

Appendix
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