Download from Git/pl

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 [$bugzilla przesłać poprawki]. (Pamiętaj jednak, że oficjalne wydania stabilne są związane z mniejszym ryzykiem wystąpienia błędów.) It allows you to download the very latest version of the source code, with all the branches and tagged releases at your disposal.

You should download from Git if you are a developer and want to submit patches.

If you do not want to develop but only install MediaWiki and extensions, then download stable tarball releases instead.

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
Aby móc korzystać z Git, musisz go najpierw zainstalować. Jest wiele metod uzyskiwania programu, w zależności od Twojego systemu operacyjnego. Follow Gerrit/Tutorial#Set up Git, or use your favorite search engine.

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



Pobieranie
Przy pomocy Git możesz pobrać jądro MediaWiki, 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.



Pobieranie dla rozwoju
Najnowsza rozwojowa wersja MediaWiki jest śledzona w gałęzi 'master'.

Po pierwsze upewnij się, że utworzyłeś konto programisty, aby mieć nazwę użytkownika ssh.

Następnie, w oknie terminala, wpisz następującą komendę do sklonowania z Twoim ssh , żebyś mógł wysyłać pathe do oceny.

Klonuje to całe podstawowe repozytorium MediaWiki, zsynchronizowane z gałęzią główną, do podkatalogu 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 przejść do różnych gałęzi lub tagów. 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.



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

Jeśli masz wolne połączenie internetowe i chcesz ograniczyć liczbę klonowanych wersji, dodaj  do polecenia.



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:

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

Update the Git submodules
Zauważ, że gałęzie mają w sobie podmoduły Git, dla powszechnie używanych rozszerzeń i motywów (gałąź master ich nie posiada). Aby zaktualizować podmoduły, uruchom: The  branch does not have these. To update the submodules, run:



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 PHAR, opcjonalnie zmień nazwę plików composer.phar zgodnie z instrukcją dla Twojego OS, następnie uruchom  w katalogu MediaWiki. Jest to zalecane podejście.
 * If the default PHP CLI version does not match the web server's PHP version, specify it with e.g..
 * 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 utworzyć katalog  wewnątrz folderu jądra Twojej instalacji MediaWiki:
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * 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.



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 motywów, więc musisz przejść do katalogu każdego rozszerzenia i motywu i zaktualizować je za pomocą polecenia takiego jak.

Należy również zaktualizować  nowszymi wersjami wymaganych bibliotek. This often means running the following Composer command, but see #Fetch external libraries above for more details:

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, oferuje on jedno polecenie, , które wykonuje wszystkie te kroki.



Przełączanie na inną wersję
Wszystkie naszye wersje są śledzone jako gałęzie lub znaczniki. Aby przejść do jednej z nich, (na przykład z gałęzi  do innej gałęzi lub tagu), checkout konkretnej gałęzi lub taga, który chcesz z katalogu klonu MediaWiki:

lub

Zmiany zostaną zastosowane automatycznie i będziesz gotowy do pracy.



Korzystanie z Git do pobrania rozszerzeń MediaWiki

 * Lista rozszerzeń w git



Pobieranie rozszerzenia

 * W następnych poleceniach, zmień  z nazwą rozszerzenia, które chcesz pobrać, bez spacji. Dla, byłoby to TitleKey. (wielkość liter ma znaczenie!)

Pobierz i sklonuj rozszerzenie z Git:

With your developer account, use these commands to get the master branch:

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

Możesz zobaczyć kod źródłowy rozszerzenia w aplikacji Gerrit's gitiles i pod adresem URL:

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



Pobieranie wszystkich rozszerzeń
Jeśli wolisz mieć wszystkie rozszerzenia MediaWiki znajdujące się na gerrit.wikimedia.org wyewidencjonowane na Twój komputer, wpisz:

With your developer account, to get the master branch:

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

After running the  command, continue with these commands:

Za każdym razem, aby zaktualizować wszystkie rozszerzenia do ich najnowszych wersji w tej gałęzi, wpisz:

Aby przejść do innej gałęzi, na przykład po wydaniu nowej wersji:

Pamiętaj, że należy używać tylko wersji rozszerzeń z tego samego wydania, co ta wersja MediaWiki i wzajemnie.

Aby śledzić gałąź główną:

Pamiętaj, że nie powinno się używać kodu master do produkcji w żadnych okolicznościach, ponieważ nie jest on uważany za stabilny.

Jeśli potrzebujesz wyewidenconować tylko do odczytu (na przykład do przeszukania lub analizy całego kodu MediaWiki), możesz użyć shared MediaWiki checkout w Labs, bez pobierania czegokolwiek na swoje urządzenia.



Usuwanie rozszerzenia

 * 1) Usuń $code lub $code2 z $LocalSettings
 * 1) Remove any line referencing the extension in   (usually in the "extra → merge-plugin → include" section)
 * 1) Usuń folder rozszerzenia w



Korzystanie z Git do pobierania motywów MediaWiki

 * Lista motywów w git

MediaWiki 1.24 i nowsze wersje nie zawierają motywów w pobieraniu Git.

Postępuj dokładnie tak samo, jak w przypadku rozszerzeń (opisanych w poprzedniej sekcji), ale używając  zamiast   we wszystkich adresach URL i ścieżkach.

Szczegółowe instrukcje instalacji są dostępne na stronie każdego motywu, tutaj, na MediaWiki.org, na przykład zobacz Skin:Vector#Installation. Instrukcje dotyczące wszystkich innych motywów są analogiczne.



Zobacz też

 * Intranet/Intranet Installation, część w pełni opracowanej serii artykułów, które używają Git dla wdrożenia MediaWiki

Appendix
The Revision as of 14:26, 21 March 2019 changed the standard of linking to gerrit.wikimedia.org: from:
 * gerrit.wikimedia.org/r/ p /mediawiki

to:
 * gerrit.wikimedia.org/r/mediawiki