MediaWiki hackeri olma

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page How to become a MediaWiki hacker and the translation is 100% complete.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Nederlands • ‎Tiếng Việt • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎interlingua • ‎italiano • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎українська • ‎বাংলা • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어

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 Geliştirici merkezi sayfasını ziyaret edin.

Wikimedia topluluğuna katılmanın diğer yolları için Katkı sağlama 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[1]. İstemci JavaScript kütüphanesi olarak jQuery'yi kullanır.

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

Geliştirme açık kaynak tarzında gerçekleşir,[4] 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.

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.

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.

Önerilen okuma

Bir geliştiricinin MediaWiki uzantısındaki bir sorguyu düzeltirken izleyin; bunlar arasında araştırma, git taahhüdü, gözden geçirilmesi ve birleştirilmesi ve Bugzilla biletinin kapatılması (artık Phabricator ile değiştirildi).

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.
  • Ü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.
  • Hatanın kendisi hakkında belirli bir sorunuz varsa, ilgili hata raporuna (normalde Phabricator 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.
  • 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. Bir hata üzerinde çalışmaya başlamadan önce planlarınızı duyurmanıza gerek yoktur, ancak memnuniyetle karşılanacaktır. 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.

İlave

MediaWiki katkıda bulunanlar Bangalore, Hindistan'da çalışıyor.

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ı
Bilmeniz gereken şeyler
  • MediaWiki'deki maintenance/eval.php betiği, MediaWiki nesneleri ve sınıfları yüklenen basit bir PHP yorumlayıcı sağlar.
  • Ayrıca, MediaWiki'deki maintenance/shell.php betiği, PsySH tabanlı maintenance/eval.php 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/MariaDB kaynakları
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 ve CSS kaynakları

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 kaynakları
  • Manual:Code — Önemli dosyaların bir listesi ve daha ayrıntılı bilgilere bağlantılar.
  • Manual:Hooks — 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.
  • Manual:Coding conventions — 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.
  • Manual:How to debug — MediaWiki'nin hata ayıklanması için bir kılavuz.
  • Manual:Eval.php — 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
MediaWiki uzantıları kaynakları

Ayrıca bakınız

  1. MediaWiki'nin tamamı PHP ile yazılmamıştır. Bazı destek araçları toplu iş dosyaları, kabuk betiği, makefile ve Python diğer dillerde yazılmıştır.
  2. MediaWiki, PHP'yi destekleyen çoğu platformda çalışır, ancak, bazı yardımcı programların veya işletim sistemi özelliklerinin eksikliği, işlevselliklerini veya performanslarını sınırlayabilir. LAMP dışı platformlarda MediaWiki.
  3. MediaWiki MySQL ve MariaDB dışındaki Veritabanı desteği var, Oracle, PostgreSQL, SQLite ve Microsoft SQL Server dahil.
  4. Geliştiriciler, çeşitli kuruluşlar için gönüllülerin ve ücretli personelin (veya müteahhitlerin) bir karışımıdır. MediaWiki kodunda çalışanların tam listesi için, Geliştiriciler makalesini okuyun.