Git'ten yükle

Git bir dağıtılmış sürüm kontrol sistemidir. Kaynak kodunun en son sürümünü, tüm dalları ve etiketli sürümleri indirmenize izin verir.

Bir geliştiriciyseniz ve yamaları göndermek istiyorsanız Git'ten indirmeniz gerekir.

Yalnızca MediaWiki ve uzantıları geliştirmek istemiyorsanız, bunun yerine kararlı tarball sürümlerini indirin yükleyin.

Daha fazla ayrıntı, özellikle de katkıda bulunmak için Git bölümüne bakın. Aşağıda birkaç ortak görev için bazı hızlı talimatlar verilmiştir.

Ön gereksinimler

Kullanmadan önce Git'in yüklü olması gerekir. İşletim sisteminize bağlı olarak Git'i edinmenin birçok farklı yolu vardır. Gerrit/Eğitim#Git kurun'u takip edin veya favori arama motorunuzu kullanın.

Üçüncü taraf kütüphanelerini indirip yüklemek için Composer yüklemeniz önerilir, ancak gerekli değildir.

MediaWiki'yi yüklemek için Git kullanmak

İndir

MediaWiki çekirdeğini Git'i ayrıca şu anda Wikimedia Foundation sunucu kümesinde yüklü olan tüm uzantıları ve Gerrit 'te barındırılan diğer birçok uzantıyı indirebilirsiniz.

İlk adım, MediaWiki çekirdek deposunu klonlamaktır. Bu işlem biraz zaman alacaktır.

Geliştirme için indirin

MediaWiki'nin en son geliştirme sürümü 'ana' dalda izlenir.

Önce bir ssh kullanıcı adınız olması için bir geliştirici hesabı oluşturduğunuzdan emin olun.

Ardından, terminal penceresinde, yamaları incelemeye gönderebilmeniz için ssh {{$1|KULLANICI ADI}} ile klonlamak için aşağıdaki komutu girin:

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

Bu ana şubeyle senkronize edilen tüm MediaWiki çekirdek deposunu mediawiki adlı bir alt dizine klonlar.

Farklı bir dizine kurmak için, komut satırında bunu değiştirin (daha fazla bilgi için bu dokümanlara bakın). Depo klonlandıktan sonra, farklı dallara veya etiketlere geçebilirsiniz. Geliştirme dalı, master, MediaWiki'nin en son geliştirici sürümüdür; üretim için ana kodu kullanmamalısınız hiçbir koşulda istikrarlı olmadığı içindir.

• En son kaynak kodunu görüntüle

Sabit bir dal indirin

Yazılım düzeltme ekleri geliştirmek istemiyorsanız, ancak kararlı sürüm dalını 1.42 anonim olarak klonlamak istiyorsanız, bunun yerine şu komutu kullanın:

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

Yavaş bir internet bağlantınız varsa ve klonlanan düzeltme sayısını azaltmak istiyorsanız, git clone komutuna --depth=1 ekleyin.

MediaWiki etiketleri (kararlı sürüm)

Alternatif olarak, MediaWiki'nin belirli kararlı sürümleri 'etiketler' kullanılarak izlenir. Bunlar tarball bültenlerine benzer. Şu anda bunlar 1.42.3 (kararlı), 1.39.10 (LTS) ve 1.39.10 (eski LTS).

Kullanılabilir tüm etiketleri şununla görebilirsiniz:

git tag -l | sort -V

Belirli bir etiketi kullanmak için, ör. En son kararlı sürüm:

git checkout 1.42.3

Git alt modüllerini güncelleyin

Dallarda, genel olarak kullanılan uzantılar ve kaplamalar için bir grup Git alt modülü vardır (ana dalda bunlar yoktur). Alt modülleri güncellemek için şunu çalıştırın: The master branch does not have these. To update the submodules, run:

cd mediawiki
git submodule update --init --recursive

Harici kütüphaneleri al

MediaWiki, hepsi MediaWiki dizinizdeki vendor/ dizininde bulunan harici PHP kitaplıklarını yönetmek için Composer öğesini kullanır.

Bu gerekli kütüphaneleri kurmak için bir seçeneğiniz vardır:

• Besteci PHAR'ı indirip yükleyin, isteğe bağlı olarak composer.phar dosyasını işletim sisteminizde belirtildiği şekilde yeniden adlandırın ve ardından MediaWiki dizininizden composer update --no-dev çalıştırın. Bu önerilen yaklaşımdır.
  • If the default PHP CLI version does not match the web server's PHP version, specify it with e.g. php7.4 composer.phar update --no-dev.
• Veya, Composer'ı kullanmak istemiyorsanız veya WMF üretim kümesinde kullanılanla aynı satıcı kitaplığı kümesini kullanmak istiyorsanız, bunun yerine MediaWiki yüklemenizin çekirdek klasörü içinde bir vendor/ dizini oluşturabilirsiniz:
  git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
  • Eğer herhangi bir eklentinizin kendi Composer gereksinimleri varsa, o zaman "bu seçeneği kullanamazsınız".

MediaWiki 1.25'ten önce, çekirdek havuzunda harici kütüphaneler tutuldu ve paket yöneticisi gerekli değildi.

Güncel kalmak

MediaWiki’nin belirli bir dalını veya geliştirme sürümünü ("ana" dalı) kullanıyorsanız, en son değişiklikleri almak nispeten kolaydır. MediaWiki klon dizininize geçin ve şu komutu verin:

git pull

Kullanmakta olduğunuz şube için yapılan son değişikliklerin tümü uygulanacaktır.

Çekirdeğin yeni sürümü daha yeni uzantı ve kaplama sürümleri gerektirebilir, bu nedenle her bir uzantı ve kaplama dizinine girmeli ve git pull --recurse-submodules gibi bir komutla güncellemelisiniz.

Ayrıca, gerekli kütüphanelerin daha yeni sürümleriyle vendor/ güncellemeniz gerekir. Bu genellikle aşağıdaki Composer komutunu çalıştırmak anlamına gelir, ancak daha fazla ayrıntı için yukarıdaki #Fetch harici kitaplıkları bölümüne bakın:

composer update --no-dev

Kodu ve gerekli kitaplıkları güncelledikten/yükselttikten sonra, veritabanı tablolarını gerektiği gibi güncellemek için MediaWiki update.php komut satırı komut dosyasını çalıştırmalısınız:

php maintenance/run.php update

MediaWiki-Vagrant kullanıyorsanız, tüm bu adımları yerine getiren tek bir komut, vagrant git-update sunar.

Farklı bir sürüme geçme

Sürümlerimizin her biri dal veya etiket olarak izlenir. Farklı bir sürüme geçmek için (örneğin master dalından farklı bir dal veya etikete), MediaWiki klon dizininizden istediğiniz dal veya etiketini kontrol edin:

git checkout <dal_adı>

veya

git checkout <etiket adı>

Değişiklikler otomatik olarak uygulanacak ve hepiniz başlayacaksınız.

MediaWiki uzantılarını indirmek için Git'i kullanma

Git içindeki uzantıların listesi

Bir eklenti indir

Sonraki komutlarda, ‎<EXT> yerine, indirmek istediğiniz uzantının adını boşluk bırakmadan yazınız. Extension:TitleKey için bu TitleKey olurdu. (harfe duyarlı!)

Git'ten bir uzantı indirin ve klonlayın:

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

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

To clone and checkout a stable release branch instead, use these commands:

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

Uzantı kaynak kodunu Gerrit'in gitiles uygulamasında ve URL adresinde görebilirsiniz:

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/HEAD

Tüm eklentileri indir

gerrit.wikimedia.org olan tüm MediaWiki uzantılarının makinenize teslim edilmesini tercih ediyorsanız, aşağıdakileri girin:

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

Or, to checkout stable releases branch instead, use this command:

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

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

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

İstediğiniz zaman, tüm uzantıları ilgili dalını en son sürümlerine güncellemek için şunu girin:

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

Yeni bir sürümden sonra olduğu gibi farklı bir şubeye geçmek için:

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

Unutmayın, yalnızca uzantı sürümlerini MediaWiki ve diğer sürümleriyle aynı sürümden kullanmanız gerekir.

Ana dalı izlemek için:

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

Lütfen üretim için ana kodu kullanmamalısınız dengesiz olarak kabul edilmemesi gerektiğini unutmayın.

Yalnızca salt okunur bir kullanıma ihtiyacınız varsa (örneğin tüm MediaWiki kodlarını greplemek veya analiz etmek için), makinelerinizden hiçbir şey indirmeden paylaşılan MediaWiki satın alma işlemini kullanabilirsiniz.

Bir eklentiyi kaldır

1. "require_once …" veya "wfLoadExtension( … )" ile LocalSettings.php üzerinden kaldırın
2. Uzantıyı composer.local.json cinsinden gösteren satırları kaldırın (genellikle "extra → merge-plugin → include" bölümünde)
3. Uzantının dizinini install-dir/extensions/ ile kaldır

MediaWiki derilerini indirmek için Git'i kullanma

Git'teki görünümlerin listesi

MediaWiki 1.24 ve sonraki sürümleri Git indirme işlemine kaplama içermez.

Uzantılarla aynı prosedürü uygulayın (önceki bölümde anlatıldığı gibi), ancak tüm URL ve yollarda skins yerine extensions kullanın.

Ayrıntılı kurulum talimatları burada her derinin sayfasında MediaWiki.org adresinde bulunabilir, örneğin bakınız Görünüm:Vektör#Kurulum. Diğer tüm kaplamalar için talimatlar benzerdir.

Ayrıca bakınız

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