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í
You can download MediaWiki core using Git, as well as all extensions currently installed on the Wikimedia Foundation server cluster and many other extensions hosted on gerrit.

The first step is to clone the MediaWiki core repository. This will take a while.

In a terminal window, enter the following command: git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git

This clones the entire MediaWiki core repository into a subdirectory named core. To install into a specific directory, add that to the command line (for more info refer to these docs). The default "branch" will be, the cutting-edge, developer version of MediaWiki. Once the repository is cloned, you can easily switch to different branches or tags (see below), including those tracking stable versions of MediaWiki.

Stažení pro další vývoj
If you have Developer access (which is easy to request), then instead of cloning anonymously with https you should clone with your ssh  so that you can submit changes for review: 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. To install these needed libraries, you have a choice:


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

Make sure you use the right branch for your MediaWiki version (e.g. REL1_25 for 1.25).
 * If you don't want to use composer, or if you want to use the same set of vendor libraries as used on the WMF production cluster, you can instead git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git to create a vendor/ directory inside the core folder of your MediaWiki installation.

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.

To see what branches are available, switch to your MediaWiki core directory and enter the following command: 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
If you're using a particular branch or the development version ("master" branch) of MediaWiki, picking up the latest changes is relatively easy. Change into your MediaWiki clone directory and issue the git pull command: 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í.

The new version of core may require newer versions of extensions and skins, so you must go into each extension and skin directory and update it with a command like git pull --recurse-submodules.

After updating/upgrading you should run the MediaWiki update.php command-line script to update database tables as needed: php maintenance/update.php

You also need to update mediawiki/vendor to any newer versions of required libraries, see.

If you use MediaWiki-Vagrant, it offers a single command, vagrant git-update, that performs all these steps.

Přepnutí na jinou verzi
Switching to a different version of MediaWiki is far simpler with Git than with SVN. Each of our versions are tracked as branches or tags. In order to switch to one of these, all you have to do is checkout the particular branch or tag you want from within your MediaWiki clone directory: 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.

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

 * List of extensions in git

Download an extension

 *  should be replaced with the name of the extension you want to download, without spaces. For Extension:TitleKey, it would be TitleKey. (case sensitive!)

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:// <USERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT>.git You can view extension source code in Phabricator's diffusion application, and at the URL:

<pre style="white-space: pre-wrap;"> https://gerrit.wikimedia.org/r/gitweb?p=mediawiki/extensions/<EXT>.git;a=tree;h=refs/heads/master;hb=master

Stažení všech rozšíření
If you prefer to have all MediaWiki extensions that are at gerrit.wikimedia.org checked out to your machine, enter the following:

Thereafter, to update all extensions to their latest versions, just enter:

Pro sledování vybrané větve:

Remove an extension
Just remove the extension folder and remove the " " from.

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

 * List of skins in git

Od MediaWiki 1.24 již nejsou grafická témata, která zajišťují vzhled wiki stránek součástí Git repozitáře "core".

Follow the exact same procedure as for extensions (described in the previous section), but using  rather than   in all URLs and paths.

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.