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 99% 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 • ‎euskara • ‎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 • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎українська • ‎қазақша • ‎العربية • ‎سنڌي • ‎فارسی • ‎अवधी • ‎हिन्दी • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어

Git je Distribuovaný systém pro správu verzí. To vám umožní stáhnout nejnovější verzi zdrojový kód, se všemi větvemi a označenými vydáními které jsou k dispozici.

Pokud jste vývojář a chcete odeslat záplaty, měli byste si ho stáhnout z Gitu.

Pokud nechcete vyvíjet, ale pouze instalovat MediaWiki a rozšíření, pak místo toho 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 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. Postupujte podle Gerrit/Tutorial#Set up Git 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é Composer, ale není to nutné.

Stažení MediaWiki přes Git

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 gerrit je také k dispozici mnoho dalších rozšíření.

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

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 měli uživatelské jméno ssh.

Abyste mohli odeslat záplaty ke kontrole, zadejte následující příkaz klonování v terminálovém okně s ssh <USERNAME>:

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

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

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 značky. Vývojová verze, master, je vývojářskou verzí MediaWiki; kód z větve master byste nikdy neměli používat na produkci, 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 1.34, použijte tento příkaz:

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

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

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 1.34.1 (stabilní), 1.31.7 (LTS) a 1.33.3 (starší).

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

git tag -l | sort -V

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

git checkout 1.34.1

Update the Git submodules

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

cd mediawiki
git submodule update --init

Stažení externích knihoven

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.
  • 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ář vendor/ uvnitř hlavní složky instalace MediaWiki:
    • With your developer account, use this command: git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/vendor.git
    • For anonymous checkout, use this command: git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
    • Pokud některá z vašich rozšíření mají své vlastní požadavky na Composer, 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ů.

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:

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.

Také musíte aktualizovat vendor/ 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:

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

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

Přepnutí na jinou verzi

Každá z našich verzí je sledována jako větve nebo značky. Chcete-li přepnout na jinou verzi (například z větve master na jinou větev nebo značku), checkout konkrétní větev nebo značku, kterou chcete z vašeho adresáře klonů MediaWiki:

git checkout <názevvětve>

nebo

git checkout <název značky>

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 <EXT> názvem přípony, kterou chcete stáhnout, bez mezer. Za Extension:TitleKey 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:

cd /path/to/extensions
git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT>

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

cd /path/to/extensions
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<EXT> --branch REL1_34

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

With your developer account, to get the master branch:

git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions

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

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

After running the git clone command, continue with these commands:

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

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

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

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

git submodule foreach 'git checkout -b origin/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 "require_once …" nebo "wfLoadExtension( … )" z LocalSettings.php
  2. Odebrat jakýkoli řádek odkazující na rozšíření v composer.local.json (obvykle v sekci "extra → merge-plugin → include")
  3. Odstraňte adresář rozšíření v install-dir/extensions/

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 skins než extensions.

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