Pobierz z Git

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 • ‎Hawaiʻi • ‎Interlingue • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎татарча/tatarça • ‎українська • ‎հայերեն • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎नेपाली • ‎हिन्दी • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
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.

Korzystanie z Git do pobrania MediaWiki

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

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

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

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

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

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 master 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 --depth=1 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:

cd mediawiki
git submodule update --init

Pobieranie dla rozwoju

Jeśli posiadasz konto programisty (o które łatwo wystąpić), zamiast klonować anonimowo przez https powinieneś klonować przez <Nazwę_użytkownika> ssh, aby móc przesłać zmiany do przeglądu:

git clone ssh://<Nazwa użytkownika>@gerrit.wikimedia.org:29418/mediawiki/core.git mediawiki

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

Pobieranie bibliotek zewnętrznych

MediaWiki używa Composer do zarządzania zewnętrznymi bibliotekami PHP, z których wszystkie znajdują się w katalogu vendor/ 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 composer update --no-dev 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ć git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git, aby utworzyć katalog vendor/ 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 1.31.1 (stabilna), 1.27.5 (LTS) i 1.30.1 (poprzednia wersja).

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

git tag -l | sort -V

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

git tag -l | sort -n -t. -k1 -k2 -k3

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

git checkout 1.31.1

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:

git checkout master

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:

git pull

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

Należy również zaktualizować vendor/ 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:

composer update --no-dev

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

php maintenance/update.php

Jeśli używasz MediaWiki-Vagrant, oferuje on jedno polecenie, vagrant git-update, 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:

git checkout <nazwa_gałęzi>

lub

git checkout <nazwa_znacznika>

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

Korzystanie z Git do pobrania rozszerzeń MediaWiki

Lista rozszerzeń w git

Pobieranie rozszerzenia

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

Pobierz i sklonuj rozszerzenie z Git:

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

Programiści klonują przez:

git clone ssh://<NAZWA_UŻYTKOWNIKA>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT> --branch REL1_31

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

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

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

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

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

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

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

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

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

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ń require_once … lub wfLoadExtension( … ) z LocalSettings.php
  2. Usuń wszelkie linie odwołujące się do rozszerzenia w composer.local.json (zazwyczaj w sekcji "extra → merge-plugin → include")
  3. Usuń katalog rozszerzenia w install-dir/extensions/

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 skins zamiast extensions 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ż