Download from Git/pl


 * Od MediaWiki 1.19beta2, 1.18.2, 1.17.3, jądro MediaWiki i rozszerzenia używają Git do kontroli wersji. Dla starszych wersji zobacz Subversion

Git jest rozproszonym systemem kontroli wersji, który pozwala użytkownikom na pobieranie najnowszych wersji gałęzi, bez oczekiwania na utworzenie pakietu. MediaWiki będzie wydawana szybciej, będziesz mógł łatwiej aktualizować swoją wersją, wrócić do poprzedniej, rozszerzyć ją czy przesłać poprawki. (Pamiętaj jednak, że oficjalne wydania stabilne są związane z mniejszym ryzykiem wystąpienia błędów.)

Zobacz Git po więcej informacji, szczególnie w celu zapewnienia wsparcia. Poniżej przedstawiono krótkie wskazówki dotyczące kilku popularnych zadań.

Wymagania wstępne
Musisz mieć zainstalowany Git, zanim będzie można go użyć. Jest wiele metod uzyskiwania programu, zależnych od Twojego systemu operacyjnego. Dla oficjalnych plików binarnych i źródłowych, odwiedź git-scm.com. Aby uzyskać alternatywne sposoby instalacji Git, użyj ulubionej wyszukiwarki, aby znaleźć instrukcje dla Twojego systemu operacyjnego.

Zaleca się zainstalowanie Composer do pobierania i instalowania bibliotek firm trzecich, ale nie jest to wymagane.

Pobieranie
Możesz pobrać jądro MediaWiki przy pomocy Git, a także wszystkie rozszerzenia zainstalowane obecnie w klastrze serwerów Wikimedia Foundation i wiele innych rozszerzeń hostowanych na.

Pierwszym krokiem jest sklonowanie głównego repozytorium MediaWiki. To chwilę potrwa.

W oknie terminala, wpisz następującą komendę:

Spowoduje to sklonowanie całego podstawowego repozytorium MediaWiki, wstępnie wskazanego na gałąź wydania, do podkatalog o nazwie.

Aby zainstalować w innym katalogu, zmień to w wierszu poleceń (aby uzyskać więcej informacji odwołaj się do tych dokumentów). Po sklonowaniu repozytorium możesz łatwo przejść do różnych gałęzi lub tagów (patrz poniżej), w tym do śledzenia niestabilnych wersji MediaWiki. Gałąź rozwojowa  jest najnowszą, programistyczną wersją MediaWiki; nie powinno się używać kodu master do produkcji w żadnych okolicznościach, ponieważ nie jest uważany za stabilny.

Jeśli chcesz ograniczyć liczbę klonowanych wersji, dodaj  do powyższego polecenia.

Zauważ, że gałęzie rozwojowe mają w sobie podmoduły Git, dla powszechnie używanych rozszerzeń i skórek (gałąź master ich nie posiada). Aby zaktualizować podmoduły, uruchom:

Pobieranie dla rozwoju
Jeśli posiadasz konto programisty (o które łatwo zażądać), zamiast klonować anonimowo przez https powinieneś klonować przez  ssh, aby móc przesłać zmiany do przeglądu:

Klonuje to całe podstawowe repozytorium MediaWiki, zsynchronizowane z gałęzią główną, do podkatalogu o nazwie.



Pobieranie bibliotek zewnętrznych
MediaWiki używa Composer do zarządzania zewnętrznymi bibliotekami PHP, z których wszystkie znajdują się w katalogu  w Twoim katalogu MediaWiki.

Aby zainstalować te wymagane biblioteki, masz do wyboru:


 * Pobierz i zainstaluj composer, przejdź do katalogu głównego, po czym uruchom . Jest to zalecane podejście.


 * Lub, jeśli nie chcesz używać programu Composer lub chcesz korzystać z tego samego zestawu bibliotek dostawców, które były używane w klastrze produkcyjnym WMF, możesz zamiast tego użyć, aby utworzyć katalog   w folderze jądra Twojej Instalacji MediaWiki. Pamiętaj, że jeśli którekolwiek z Twoich rozszerzeń ma własne wymagania Composer'a, nie możesz użyć tej opcji.

Przed wersją MediaWiki 1.25 zewnętrzne biblioteki były przechowywane w głównym repozytorium i nie był wymagany żaden menedżer pakietów.

Znaczniki MediaWiki (wersja stabilna)
Alternatywnie, określone stabilne wersje MediaWiki są śledzone przy użyciu 'tagów'. Są one analogiczne do wydań tarball. Obecnie są to (stabilna),  (LTS) i  (poprzednia wersja).

Możesz zobaczyć wszystkie dostępne tagi używając:

Korzystając z polecenia sortowania niezgodnego z GNU, np. w Mac OS X, musisz polegać na starych dobrych separatorach:

Aby użyć określonego tagu, np. najnowsze stabilne wydanie:

Najnowsza wersja rozwojowa MediaWiki
Najnowsza rozwojowa wersja MediaWiki jest śledzona w gałęzi 'master'. To jest to, co jest domyślnie wyewidencjonowane lokalnie, kiedy po raz pierwszy klonujesz repozytorium MediaWiki. Jeśli przełączysz się do innej gałęzi, ale chcesz wrócić do korzystania z najnowszej wersji MediaWiki:

Aktualizowanie
Jeśli używasz konkretnej gałęzi lub wersji rozwojowej (gałęzi "master") MediaWiki, pobranie najnowszych zmian jest stosunkowo łatwe. Przejdź do katalogu z klonem MediaWiki i wydaj polecenie:

Zostaną zastosowane wszystkie najnowsze zmiany dla gałęzi, z której korzystasz.

Nowa wersja jądra może wymagać nowszych wersji rozszerzeń i skórek, więc musisz przejść do katalogu każdego rozszerzenia i skórki i zaktualizować je za pomocą polecenia takiego jak.

Należy również zaktualizować  nowszymi wersjami wymaganych bibliotek. Często oznacza to uruchomienie następującego polecenia Composer, ale zobacz Pobieranie bibliotek zewnętrznych powyżej, aby uzyskać więcej szczegółów:

Po aktualizacji kodu i wymaganych bibliotek powinno się uruchomić skrypt wiersza poleceń MediaWiki, aby w razie potrzeby zaktualizować tabele bazy danych:

Jeśli używasz MediaWiki-Vagrant, oferuje on jedno polecenie,, które wykonuje wszystkie te kroki.

Przełączanie na inną wersję
Przełączenie na inną wersję MediaWiki jest o wiele prostsze w przypadku Git niż w przypadku SVN. Wszystkie naszye wersje są śledzone jako gałęzie lub znaczniki. Aby przejść do jednej z nich, wszystko, co musisz zrobić, to wykonać checkout konkretnej gałęzi lub taga, który chcesz z katalogu klonu MediaWiki:

lub

The changes will be applied automatically and you will be all set to go.

Korzystanie z Git do pobrania rozszerzeń MediaWiki

 * List of extensions in git

Pobierz rozszerzenie

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

Download and clone an extension from Git:

Developers clone with:

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

 https://gerrit.wikimedia.org/g/mediawiki/extensions//+/refs/heads/master

Pobieranie wszystkich rozszerzeń
If you prefer to have all MediaWiki extensions that are at gerrit.wikimedia.org checked out to your machine, enter the following:

Następnie, aby zaktualizować wszystkie rozszerzenia do ich najnowszych wersji, wystarczy wpisać:

Aby śledzić określoną gałąź:

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

To track the master branch:

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.

Usuwanie rozszerzenia
Po prostu usuń folder rozszerzenia, a następnie usuń „ ” z.

Korzystanie z Git do pobierania motywów MediaWiki

 * Lista motywów w git

MediaWiki 1.24 and later don't include skins in the Git download.

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

Detailed installation instructions are available on each skin's page here on MediaWiki.org, for example see Skin:Vector#Installation. Instructions for all other skins are analogous.

Zobacz też

 * Migracja z SVN do Git
 * Nightlies, alternatywa do pobierania z Git
 * Intranet/Intranet Installation, part of a fully worked series of articles that uses Git for MediaWiki deployment