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
Aby móc korzystać z Git, musisz go najpierw zainstalować. 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
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.

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 opublikowane mają w sobie podmoduły Git, dla powszechnie używanych rozszerzeń i motywów (gałąź master ich nie posiada). Aby zaktualizować podmoduły, uruchom:

Pobieranie dla rozwoju
Jeśli posiadasz konto programisty (o które łatwo wystąpić), 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 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.
 * 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 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. 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

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

Korzystanie z Git do pobrania rozszerzeń MediaWiki

 * Lista rozszerzeń w git

Pobieranie rozszerzenia

 *  należy zastąpić nazwą rozszerzenia, które chcesz pobrać, bez spacji. Dla, byłoby to TitleKey (wielkość liter ma znaczenie!).

Pobierz i sklonuj rozszerzenie z Git:

Programiści klonują przez:

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:

Następnie, aby zaktualizować wszystkie rozszerzenia do ich najnowszych wersji w tej gałęzi, wystarczy wpisać:

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ń   lub   z
 * 2) Remove any line referencing the extension in   (usually in the "extra → merge-plugin → include" section)
 * 3) 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ż

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