Gerrit/Eğitim/çu;o

Bu kısa çu;o tarzı rehber Git konusunda biraz deneyimi olan ve MediaWiki geliştirmesi için Gerrit'e başlamak isteyen geliştiricilere yöneliktir. Açıklamaları içeren bir eğitim için Gerrit/Eğitim sayfasına bakın.

Ön koşullar

1. git-review ve Git'i yükle.
2. Wikimedia Gerrit ile kullanmak için yeni bir SSH anahtarı oluşturun:
   • Aşağıdakini terminalinizden çalıştırın, e-posta adresinizi kullanın:

     ssh-keygen -t ed25519 -C "your_email@example.com"

   • "Enter a file in which to save the key" isteminde, eğer bu sizin ilk SSH anahtarınızsa varsayılanı kabul etmek için Enter tuşa basabilirsiniz. Aksi takdirde, bunu /Users/YOUR_NAME/.ssh/id_wikimedia_gerrit gibi bir şeye özelleştirin
   • "Enter passphrase:" isteminde güçlü bir parola seçin. Değişiklik isteklerini çekerken veya gönderirken genellikle ilk kez belirli bir günde bunu yapmanız gerekecektir.
3. Bir Wikimedia geliştirici hesabı oluşturun. Daha sonra gerrit.wikimedia.org adresine oturum açın ve genel anahtarınızı hesabınıza ekleyin. Genel anahtar /Users/you/.ssh/id_wikimedia_gerrit.pub konumun içeriğidir
4. E-posta adresinizi, adınızı ve SSH kullanıcı adınızı ayarlamak için Git'i yapılandırın .

Kodu al

Depo tarayıcısındaki komutu kullanarak depoyu kopyalayın (örneğin, https://gerrit.wikimedia.org/g/mediawiki/core). Bunları listesinde veya mediawiki.org üzerindeki uzantı bilgi kutusunda bulabilirsiniz. En sık klonlanan depolar şunlardır:

MediaWiki çekirdeği için: git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki

Veya bir uzantı için: git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<uzantı>.git

MediaWiki görünümleri: git clone https://gerrit.wikimedia.org/r/mediawiki/skins/<görünüm>.git

Yamanızı yazın

Dalınızı en son üretim dalından başlatın:

mediawiki$ git checkout master
mediawiki$ git pull
mediawiki$ git checkout -b anlamlı-dal-adı

NOT

Bazı durumlarda üretim dalı "production" veya "main" olarak adlandırılabilir ve şu şekilde değiştirilmiş bir çıkış komutu gerektirebilir:

mediawiki$ git checkout production

mediawiki$ git checkout main

Artık değişikliklerinizi yapmak ve test etmek için kodu düzenleyebilirsiniz. Memnun kaldığınızda ve kod kullanıma hazır olduğunda:

• git commit --all Gerrit ile çalışırken bunu her dal için yalnızca bir kez yapın. Hataları düzeltmek için git commit --amend kullanın.
• git show Bize ne gönderdiğinizi onaylamak için yamanızı inceleyin. Çıkmak için "q" tuşuna basın.
• git review Bu Gerrit'e iletilir ve bir değişiklik talebi oluşturulur. Eğer bir hata alırsanız ve daha önce eski "gerrit-tools" programını yüklediyseniz, bunun yerine "git-review" programını yükleyin.

Değişikliğinizi gözden geçirecek bir veya iki bakımcıyı davet etmeniz önerilir. Değişiklik talebini oluşturduktan sonra, git review değişiklik talebinizin URL'sini yazdıracaktır. Ayrıca, Gerrit panonuz aracılığıyla değişikliklerinizi de bulabilirsiniz. "Reviewers" altındaki değişik sayfasında "Add Reviewer" kalem düğmesine tıklayın. Giriş kutusuna bir gözden geçiren adı yazın. İnceleme için kimi davet edeceğinizi bilmiyorsanız, değiştirdiğiniz bileşenin bakımcılar listesini kontrol edin veya IRC (#mediawiki ^bağlan) kanalda sorun.

Yamanızı güncelleyin

Bir gözden geçiren sizden değişiklik yapmanızı isterse, onayınızı aşağıdaki şekilde düzeltin:

• git review -d değişik_kimlik ör. https://gerrit.wikimedia.org/r/1234 içinde 1234. Bu, Gerrit'ten gelen değişiklik talebini indirir ve kontrol eder.
• Değişikliklerinizi yapmak için kaynak dosyalarını düzenleyin.
• git commit --all --amend Bunu istediğiniz kadar tekrarlayabilirsiniz. Taahhüt mesajını düzenlerken "Change-Id" satırını olduğu gibi bırakın.
• git review Bu, Gerrit'teki değişiklik isteğinizi, değişikliğinizi yansıtan yeni bir yama seti sürümüyle günceller ve abone olan inceleyicileri otomatik olarak bilgilendirir.

Ayrıca bakınız

• Taahhüt gönderme yönergelerimizi takip etmeye çalışın
• Ayrıca bkz: İnceleme alma