Stažení z Gitu

From MediaWiki.org
Jump to: navigation, search
This page is a translated version of the page Download from Git and the translation is 68% complete.

Outdated translations are marked like this.
Other languages:
aragonés • ‎العربية • ‎asturianu • ‎تۆرکجه • ‎беларуская (тарашкевіца)‎ • ‎български • ‎català • ‎čeština • ‎dansk • ‎Deutsch • ‎Ελληνικά • ‎English • ‎Esperanto • ‎español • ‎euskara • ‎فارسی • ‎suomi • ‎français • ‎galego • ‎Hawaiʻi • ‎עברית • ‎magyar • ‎Հայերեն • ‎Bahasa Indonesia • ‎Interlingue • ‎italiano • ‎日本語 • ‎ქართული • ‎Taqbaylit • ‎한국어 • ‎Lëtzebuergesch • ‎lietuvių • ‎Bahasa Melayu • ‎Napulitano • ‎नेपाली • ‎Nederlands • ‎occitan • ‎polski • ‎پښتو • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎sicilianu • ‎Scots • ‎سنڌي • ‎slovenčina • ‎српски / srpski • ‎svenska • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎Türkçe • ‎татарча/tatarça • ‎ئۇيغۇرچە • ‎українська • ‎Tiếng Việt • ‎ייִדיש • ‎粵語 • ‎中文
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í MediaWiki přes Git

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ý bude nějakou chvíli trvat, je naklonování repozitáře MediaWiki core.

In a terminal window, enter the following command:

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

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://<USERNAME>@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 máte na výběr:

  • 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.
  • 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 git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git a stažený obsah repozitáře umístit do adresáře vendor/ v kořeni instalace vaší MediaWiki.

Make sure you use the right branch for your MediaWiki version (e.g. REL1_25 for 1.25).

Specifika verzí 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 složky vašeho klonu MediaWiki core a spusťte následující příkaz:

git branch -r | sort -V

Hlavní vydání jsou vidět jako "origin/REL<release number>", např. "origin/REL1_29". Pro přepnutí na tyto větve musíte udělat:

git checkout -b REL<release number> origin/REL<release number>

Například pro přepnutí na aktuální stabilní verzi 1.29.0, zadejte:

git checkout -b REL1_29 origin/REL1_29
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 <tag name>

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 („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 příkaz git 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í.

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.

Po aktualizaci/upgradu musíte ještě v příkazovém řádku spustit update.phpManual:update.php script, aby byly podle potřeby aktualizovány databázové tabulky:

php maintenance/update.php

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

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

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 <branchname>

nebo

git checkout <tag name>

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

Stažení rozšíření

<EXT> 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/<EXT>.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:

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í

Pokud chcete mít k dispozici všechna rozšíření MediaWiki, která jsou na gerrit.wikimedia.org pak vlož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_29 origin/REL1_29 || :'

If you only need a read-only checkout (for instance to grep or analyse all MediaWiki code), you can use the shared MediaWiki checkout on Labs, without downloading anything on your machines.

Remove an extension

Just remove the extension folder and remove the "require_once …" from LocalSettings.php.

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 skins rather than extensions 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éž