Stažení z Gitu

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Download from Git and the translation is 76% complete.
Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Esperanto • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Tiếng Việt • ‎Türkçe • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎українська • ‎العربية • ‎سنڌي • ‎فارسی • ‎अवधी • ‎हिन्दी • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
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í

Přes Git lze stáhnout nejenom jádro MediaWiki, ale i všechna rozšíření instalovaná na serverech clusteru Wikimedia Foundation a stejně tak mnohá další rozšíření hostovaná na gerrit .

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:

git clone https://gerrit.wikimedia.org/r/mediawiki/core.git --branch REL1_34 mediawiki

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

To install into different directory, change that in the command line (for more info refer to these docs). Once the repository is cloned, you can easily switch to different branches or tags (see below), including those tracking unstable versions of MediaWiki. The development branch, master, is the cutting-edge, developer version of MediaWiki; you should not use master code for production under any circumstances as it is not considered stable.

If you want to reduce the number of revisions that are cloned, add --depth=1 to the above command.

The release branches have a bunch of Git submodules in them, for commonly-used extensions and skins (the master branch does not have these). To update the submodules, run:

cd mediawiki
git submodule update --init

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 <UŽIVATELSKÉ JMÉNO>, abyste mohli odeslat změny ke kontrole:

git clone ssh://<UŽIVATELSKÉJMÉNO>@gerrit.wikimedia.org:29418/mediawiki/core.git mediawiki

This clones the entire MediaWiki core repository, synced to the master branch, into a sub-directory named mediawiki.

Stažení externích knihoven

MediaWiki uses Composer to manage external PHP libraries, all of which end up in the vendor/ directory in your MediaWiki directory.

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

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

  • Stáhněte a doinstalujte composer, skočte do vašeho „core“ adresáře a pak spusťte 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/mediawiki/vendor.git a stažený obsah repozitáře umístit do adresáře vendor/ v kořeni instalace vaší MediaWiki. Note that if any of your extensions have their own Composer requirements, then you cannot use this option.

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. Ty odpovídají vydáním, ze kterých se dělají tarbally. V současné době sw jedná o 1.34.0 (stabilní), 1.31.6 (LTS) a 1.33.2 (starší).

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

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, např. nejnovější stabilní verze:

git checkout 1.34.0

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 tento příkaz:

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

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 git pull --recurse-submodules.

You also need to update vendor/ with any newer versions of required libraries. This often means running the following Composer command, but see #Fetch external libraries above for more details:

composer update --no-dev

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

php maintenance/update.php

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

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:

git checkout <názevvětve>

nebo

git checkout <název značky>

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

Seznam rozšíření na gitu

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/mediawiki/extensions/<EXT> --branch REL1_34

Vývojáři klonují takto:

git clone ssh://<UŽIVATELSKÉJMÉNO>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT> --branch REL1_34

You can view extension source code in Gerrit's gitiles application, and at the URL:

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/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í:

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

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

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

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

git submodule foreach 'git checkout -b REL1_33 origin/REL1_33 || :'

Remember that you should only use versions of extensions from the same release as that version of MediaWiki and each other.

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

git submodule foreach 'git checkout -b origin/master || :'

Please note that you should not use master code for production under any circumstances as it is not considered stable.

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.

Odstranění rozšíření

  1. Odstraňte "require_once …" nebo "wfLoadExtension( … )" z LocalSettings.php
  2. Remove any line referencing the extension in composer.local.json (usually in the "extra → merge-plugin → include" section)
  3. Remove the extension's directory in install-dir/extensions/

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

Seznam témat na gitu

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