How to become a MediaWiki hacker/tr

Bu madde, geliştiricilerin MediaWiki çekirdeği ve MediaWiki uzantılarının geliştirilmesine katkıda bulunmak için gereken temel becerileri öğrenmelerine yardımcı olmak için yazılmıştır'''. Çoğu durumda MediaWiki ile çalışırken, ne yaptığınızı gerçekten bilmiyorsanız MediaWiki çekirdeğini hack yapmak istemezsiniz.

Wikimedia geliştirmeye başlamak için ana yol mentorluk sunan Wikimedia projelerine katkıda bulunmaktır. Mentorluk yapmadan bir alternatif iyi ilk hatayı düzeltmektir.

MediaWiki'yi zaten tanıdık deneyimli bir geliştiriciyseniz, onun yerine  sayfasını ziyaret edin.

Wikimedia topluluğuna katılmanın diğer yolları için  sayfasına bakın.

Genel bakış
MediaWiki, Vikipedi'nin, onun kardeş projelerinin ve binlerce vikinin tüm dünyada güç sağlayan bir yazılımdır.

MediaWiki PHP programlama dilinde yazılmıştır. İstemci JavaScript kütüphanesi olarak jQuery'yi kullanır.

MediaWiki, öncelikle LAMP platformu için yazılmıştır ve çoğu işletim sisteminde çalışır. MediaWiki öncelikle MySQL ve MariaDB veritabanı sunucularını kullanır.

Geliştirme açık kaynak tarzında gerçekleşir, gönüllü topluluk geliştiricileri de büyük bir rol oynar, ancak büyük ölçüde çevrimiçi olarak koordine edilir ve Wikimedia Vakfı tarafından desteklenir.


 * Geliştirme tartışması çeşitli posta gönderme listeleri ve IRC kanallarında MediaWiki üzerinde gerçekleşir. Ana geliştirici listesi wikitech-l. Ana geliştirici IRC kanalları #mediawiki ve #wikimedia-dev şeklindedir.
 * Kaynak kodu, Git revizyon kontrol sistemi https://phabricator.wikimedia.org/diffusion/ veya Gerrit'i kullanarak kaynak kodu sisteminize indirin.
 * Kod incelemesi üzerinde yapılır. Yamaları göndermek üzere Git ve Gerrit'i ayarlamak için bu eğitimi izleyin.
 * Hata raporları ve görevler Phabricator üzerinde yönetilir.

Bu sayfa MediaWiki'ye katkıda bulunmanıza yardımcı olmalıdır. Öğretici değildir; gerekli olanı öğrenmek için gidebileceğiniz çeşitli yerlere işaret ediyor.

Geliştirme ortamınızı kurun
Çoğu proje Git ve Gerrit kullanır. Geliştirici hesabınızı oluşturmak için Gerrit eğitimini uygulayın. Ardından, kodumuzu indirmek, değişiklik yapmak, test etmek ve yamalar göndermek için devam edebilirsiniz. Geliştirme ortamınızı ayarlamanın iki yolu vardır: önceden yapılandırılmış bir sanal makine kurulumu (Vagrant veya Docker) veya manüel yapılandırma yaklaşımı kullanma.

Vagrant ile Sanal Makine

 * Vagrant kurulumu — Bu adımlar MediaWiki sunucusunu bir Linux sanal makinesi içerisindeki tüm gereksinimlerle birlikte yükleyecektir (Linux, Windows veya Mac bilgisayarlarda kullanılabilir).

Docker geliştirme ortamı

 * MediaWiki Docker – MediaWiki'yi Docker kullanarak çalıştırın (Linux, Windows veya macOS ana bilgisayarlarında kullanılabilir).

Manüel kurulum

 * Kurulum gereksinimleri — Donanım gereksinimlerini kontrol edin ve bir LAMP, MAMP veya WAMP sunucusu (Linux, Mac veya Windows, ayrıca Apache, MySQL/MariaDB ve PHP) yükleyin.


 * — En son kaynak kodunu Git'ten indirin.
 * - Yükleme ve başlangıç ​​yapılandırmasına devam edin.
 * Uyarı ve hataları erkenden görüntülemek için ortamınızdaki çeşitli hata ayıklama modlarını ayarlayın.

MediaWiki özelliklerini geliştirmek için Vikipedi veritabanı dökümlerini indirmek gerekli değildir. Aslında, çoğu durumda, birkaç özel hazırlanmış sınama sayfası bulunan boş boş bir veritabanını kullanmak daha kolaydır. Bununla birlikte, eğer bir nedenle Vikipedi'nin bir kopyasını almak istiyorsan, bir dökümü alabilirsiniz.

Communication tips and guidelines




Geri bildirim, sorular ve destek

 * Öncelikle kendinize bazı temel araştırmalar yapmanız beklenmektedir: Koda bakınız, ne yapmanız gerektiği konusunda fikir sahibi olmaya çalışınız, ilgili dokümanları okumaya çalışın, hatayı düzeltmek için sırayla değişiklik yapmanız gereken muhtemel yerleri bulmaya çalışın.
 * In a Phabricator task, see the project tags in the side bar to find out which code repository a task is about.
 * Üzerinde çalışmak istediğiniz belirli bir görevle ilgili olmayan genel sorularınız varsa, IRC sohbeti veya posta listeleri gibi genel kanalları kullanın, ancak belirli bir görevi kullanmayın. Questions how to set up your development environment or how to use Gerrit are out of scope for a task.
 * Hatanın kendisi hakkında belirli bir sorunuz varsa, ilgili hata raporuna (normalde içindeki bir görev) yorum yapın. "Bu hatayı nasıl düzeltebileceğiniz konusunda daha fazla bilgi verebilir misiniz?" ile başlamak için iyi bir soru değildir: Sorularınız ne kadar spesifik olursa, birilerinin bu sorulara hızlı bir şekilde yanıt vermesi daha olasıdır. Hatayı nasıl düzeltebileceğiniz hakkında hiçbir fikriniz yoksa, belki de bu hata (henüz) sizin için değil, lütfen önce daha kolay bir tane bulmayı düşünün.
 * Sorarken, başkalarının doğru seviyede yardımcı olabilmesi için, denediğiniz ve keşfettiğiniz şeyleri ayrıntılı bir şekilde anlatın. Belirli olmaya çalışın - örneğin, kendi sözcüklerinizde bir ifade vermek yerine, komutlarınızı ve çıktılarını (eğer çok uzun değilse) kopyalayıp yapıştırın. Bu, yanlış anlaşılmaları önler.
 * Bir görev üzerinde çalışıp çalışamayacağınızı sormayın. Do not ask to assign a task to you.
 * Sosyal medya kanallarımızdaki özel e-posta veya destek taleplerinden kaçının.
 * Giriş ve yorumlar ararken lütfen sabırlı olunuz. IRC'de sormak istemeyin, sadece sor: IRC kanalında soruyorsanız çoğu soru diğer topluluk üyeleri tarafından da yanıtlanabilir. Eğer kimse cevap vermezse, sorunla ilgili hata raporunda veya viki sayfasında sorun; Sadece soruyu bırakmayın.

Bir görev üzerinde çalıştığınızı belirtin
Bir görev üzerinde çalışıp çalışamayacağınızı sormayın. Do not ask to assign a task to you. You do not need to announce your plans before you start working on a bug, but it would be welcome. Kendinizi bir görevde görevli olarak atayabilirsiniz: Phabricator'daki Eylem Ekle… → Ata/Talep et açılır menüsünü kullanın. En azından görev için bir yama önermeye yakın olduğunuzda, üzerinde çalıştığınız bir yorumda duyurmak iyidir. Duyurunuz, başkalarının hata üzerinde aynı anda çalışmamalarına ve işleri kopyalamamasına yardımcı olur.

Ayrıca, bir görevin Gerrit'teki bir düzeltme ekine zaten yakın bir bağlantısı varsa ve Phabricator'da ilişkili "İnceleme için Düzeltme Eki" projesi varsa bunun yerine üzerinde çalışmak için farklı bir görev seçin, çoğaltmaktan kaçının. Gerrit'teki mevcut bir yama birleştirilmediyse ve uzun zamandır herhangi bir değişiklik görmediyse, Gerrit'teki ve görevdeki geri bildirimlere dayanarak mevcut yamayı alıp geliştirme de yapabilirsiniz.

Bir görev üzerinde çalışmayı bırakırsanız, kendinizi görevin atananı olarak kaldırın, böylece diğerleri görev üzerinde çalışabileceklerini bilir ve hala üzerinde çalışmanızı beklemezler.

Erken iletişim kurarak topluluk üyelerinden daha fazla ilgi, geri bildirim ve yardım alırsınız.



PHP
MediaWiki PHP ile yazılmıştır, bu nedenle MediaWiki'nin çekirdeğini kesmek için PHP'ye aşina olmanız gerekir.


 * PHP öğrenin
 * PHP eğitimi — Birçok farklı dilde mevcuttur. Eğer PHP hakkında hiçbir bilgiye sahip değilseniz, ancak diğer nesne tabanlı programlama dillerinde nasıl program yapacağınızı biliyorsanız, PHP öğrenmenizi kolaylaştıracaktır.
 * PHP Programming at Wikibooks.
 * PHP topic at Wikiversity.


 * PHP kaynakları:
 * PHP el kitabı — Birçok farklı dilde mevcuttur.
 * MediaWiki topluluğu içindeki PHP kodlama kuralları.


 * Bilmeniz gereken şeyler:
 * MediaWiki'deki  betiği, MediaWiki nesneleri ve sınıfları yüklenen basit bir PHP yorumlayıcı sağlar.
 * Ayrıca, MediaWiki'deki  betiği, PsySH tabanlı   yerine geçer, Manual:Shell.php sayfasına bakın..

Veritabanı
Birçok özellik, bir miktar veritabanı manipülasyonu gerektirir, bu nedenle sıklıkla MySQL/MariaDB'yi tanımanız gerekir.


 * MySQL/MariaDB'yi öğrenin
 * MySQL eğitimi — MySQL 5.0 kaynak el kitabından.
 * MySQL at Wikibooks.


 * MySQL/MariaDB kaynakları
 * MySQL Başvuru Kılavuzları — Birçok farklı dilde mevcuttur.
 * MariaDB Bilgi Tabanı
 * MediaWiki topluluğunda veritabanı kodlama sözleşmeleri.


 * Bilmeniz gereken şeyler:
 * Kodunuzu MySQL/MariaDB ile test edin.
 * MediaWiki şu anda birincil veritabanı arka uç olarak MySQL ve MariaDB'yi kullanmaktadır. Ayrıca PostgreSQL ve SQLite gibi diğer DBMS'leri de destekler. Bununla birlikte, hemen hemen tüm geliştiriciler MySQL/MariaDB'yi kullanır ve sonuç olarak düzenli olarak kesilen diğer DB'leri test etmezler. Bu nedenle, özellikle başka bir DB için desteği geliştirmeye çalışmadıkça yamaları test ederken MySQL/MariaDB'yi kullanmanız önerilir. İkinci durumda, MySQL/MariaDB'yi kırmamaya özen gösterin (veya içinde korkunç derecede yetersiz olan soruları yazın), çünkü MySQL/ MariaDB herkesin kullandığı şeydir.

JavaScript ve CSS
JavaScript ve CSS, ön uç kodunda her zaman mevcut hale geldi. MediaWiki'de çalışmak için JavaScript, jQuery ve CSS hakkında bilgi sahibi olmak zorunda değilsiniz, ancak ne üzerinde çalışmayı seçtiğinize bağlı olarak yapmanız gerekebilir.


 * JavaScript ve CSS'yi öğrenin
 * JavaScript and CSS at Wikibooks.
 * JQuery ile Başlarken — Bir jQuery öğrenimi.
 * Learning JavaScript — references and sources.


 * JavaScript ve CSS kaynakları
 * MediaWiki topluluğu içindeki JavaScript kodlama kuralları.
 * MediaWiki topluluğu içindeki CSS kodlama kuralları.

MediaWiki
MediaWiki kod tabanı büyük ve bazı bölümleri çirkin; onun tarafından kaplamayın. İlk başladığınızda, yalnızca küçük bir kod bölgesine dokunan özellikler yazmayı veya hataları düzeltmeyi hedefleyin.


 * MediaWiki ile ilgili temel bilgiler ve okunması gereken bilgiler:
 *  — MediaWiki'nin ana bileşenleri ve birbirleriyle nasıl çalıştıkları üzerine üst düzey bir bakış.
 *  — Neden ve nasıl güvenli kod yazacağınıza genel bir bakış.


 * MediaWiki kaynakları:
 * — Önemli dosyaların bir listesi ve daha ayrıntılı bilgilere bağlantılar.
 * — Kanca listesi. Kod tabanının bir kısmının bir şey yaptığını bulmaya çalışıyorsanız, genellikle başlamak için iyi bir yer ilgili kancaları aramaktır.
 * — MediaWiki topluluğunda genel kodlama sözleşmelerine genel bir bakış.


 * Kod belgelemesi (sınıf kaynağı) — Kod ve kod yorumlarını otomatik olarak oluşturulan belgeler.
 * — MediaWiki'nin hata ayıklanması için bir kılavuz.
 * — MediaWiki nesneleri ile etkileşim kurmak için bir araç yaşıyor.

MediaWiki uzantıları
MediaWiki uzantıları koduyla çalışmayı seçerseniz, aşağıdaki bağlantılar daha fazla bilgi sağlar.


 * MediaWiki uzantılarına ilişkin temel bilgiler:
 * Geliştirme uzantıları — MediaWiki için bir uzantı yazma.
 * Uzantı yazma eğitimi


 * MediaWiki uzantıları kaynakları:
 * Uzantılar için en iyi uygulamalar
 * MediaWiki uzantısı geliştirmeye kısa bir giriş — MediaWiki uzantısının nasıl oluşturulacağı hakkında bir video sunumu (slaytlar).
 * MediaWiki uzantısı oluşturma — MediaWiki için bir eklentinin nasıl geliştirileceğini, en iyi uygulamaları ve MediaWiki topluluğunun nasıl dahil edileceğini kapsar. Şubat 2011'den itibaren.
 * Geliştirici Merkezi'ndeki uzantı geliştiricileri için yardım

Ayrıca bakınız

 * Depolarda kod arayın
 * – Bu maddede ki bilgileri tamamen okuduğunuzda, geliştirici merkezinde ki bilgilere geçme zamanı gelmiştir.
 * – ilgili sayfalar koleksiyonu