Çevirmen PO dosyasındaki Almanca metni düzeltiyor, ancak site eski cümleyi göstermeye devam ediyor. Düzenlenebilir katalog güncellenmiş olsa da WordPress çevirileri MO dosyasından okuduğu için değişiklik görünmüyor.
Bu rehberde PO ve MO dosyalarının rollerini, güvenli derleme adımlarını ve WordPress sisteminin doğru kataloğu yüklediğini nasıl doğrulayacağınızı öğreneceksiniz.
PO ve MO dosyaları ne işe yarar?
PO dosyası kaynak metinleri, çevirileri, bağlamı ve çoğul kurallarını içeren düzenlenebilir gettext kataloğudur. MO dosyası ise WordPress’in kullandığı ikili çıktıdır. Derleme, PO içeriğini MO biçimine dönüştürür; yanlış text domain, yerel ayar veya dosya yolunu kendiliğinden düzeltmez.
- Eklenti ya da temanın text domain değerini ve etkin WordPress yerel ayarını doğrulayın.
- PO ve MO dosya adlarının ve yükleme klasörünün WordPress sisteminin beklediği yapıyla eşleştiğini kontrol edin.
- Derleme hatası, boş çıktı veya karakter bozulması görülürse önceki PO ve MO çiftine dönün.
Gerçekçi bir WordPress örneği
Bir eklentinin Almanca çevirisi güncelleniyor, ancak yalnız PO dosyası sunucuya yükleniyor. Ekip doğru yerel ayarı ve text domain değerini kontrol edip PO dosyasını yeniden derliyor. Yeni MO dosyası doğru klasöre yerleştirildikten sonra hem tekil hem çoğul bir metin temiz oturumda doğrulanıyor.
Neden önemlidir ve ne zaman kullanılır?
PO dosyası değiştiğinde WordPress sisteminin okuyacağı MO çıktısının da yeniden üretilmesi gerekir. Derleme; yeni veya düzeltilmiş çeviriyi yayımlarken, bozuk kataloğu onarırken ya da sürüm paketine yeniden üretilebilir bir dil dosyası eklemek gerektiğinde kullanılır.
Önce yanlış metnin gerçekten ilgili katalogdan geldiğini kanıtlayın. Aynı text domain için eklenti klasörü, dil paketi ve özel dil dizini gibi birden fazla kaynak bulunabilir; son yüklenen katalog beklediğiniz dosya olmayabilir.
Yeni başlayanlar için güvenli yöntem
- Mevcut PO ve MO dosyalarının geri yüklenebilir kopyasını alın; dosya adlarını, yollarını ve hash değerlerini kaydedin.
- PO üst bilgisini, UTF-8 kodlamasını, çoğul kurallarını ve hatalı ya da yinelenen iletileri kontrol edin.
- Yalnız amaçlanan PO dosyasını desteklenen gettext aracı veya WP-CLI ile eşleşen MO hedefine derleyin.
- MO dosyasını elle düzenlemeyin; asıl ve düzenlenebilir çeviri kaynağı PO dosyası olarak kalmalıdır.
- Doğru yerel ayarda, oturum açılmamış sayfada ve gerekiyorsa wp-admin içinde bilinen tekil ve çoğul çevirileri doğrulayın.
İleri teknik doğrulama
İleri incelemede derleme çıktısını, WordPress sisteminin gerçekten yüklediği katalogla eşleştirin.
- Derleyici uyarılarını ilgili PO satırı, çoğul kuralı veya bozuk iletiyle birlikte çözün.
- Kaynak ve çıktı hash değerlerini, derleyici sürümünü, komutu, yerel ayarı, text domain değerini ve hedef yolu kaydedin.
- Eklenti güncellemesi, dil paketi veya container yeniden kurulumu sırasında dosyanın ezilip ezilmeyeceğini belirleyin.
- Örnek bir çeviriyi kontrollü olarak değiştirip yalnız beklenen metnin güncellendiğini doğrulayın; ardından onaylı kataloğa dönün.
Riskler, sık hatalar, yedek ve geri dönüş
En sık hata, PO dosyasını güncelleyip MO dosyasını eski bırakmak veya doğru çıktıyı yanlış klasöre koymaktır.
- MO dosyasının tarihine bakarak doğru kataloğun yüklendiğini varsaymayın.
- Text domain, yerel ayar ve dosya adı eşleşmeden geniş çaplı dosya kopyalamayın.
- Kaynak PO dosyasını silmeyin ve ikili MO içeriğini doğrudan düzenlemeyin.
- Yeni derleme ilgisiz çevirileri bozarsa ya da WordPress kataloğu yükleyemezse önceki çifti geri getirin.
Derleme kaydına kaynak ve hedef yolu, hash değerlerini, araç sürümünü ve WordPress içinde görülen örnek metinleri ekleyin.
AIOWS nasıl yardımcı olur?
AIOWS Dil Derleyici
AIOWS Dil Derleyici, desteklenen WordPress dil kaynaklarını merkezî bir ekranda incelemenize ve seçilen PO dosyasından WordPress’in kullandığı MO çıktısını üretmenize yardımcı olur. İşleme başlamadan önce doğru yerel ayarı, text domain değerini, kaynak yolu ve mevcut MO dosyasını belirleyin. Böylece farklı eklenti, tema veya dil paketlerine ait katalogların birbirine karışma riski azalır.
Derlemeden önce katalogda bildirilen sorunları inceleyin ve yalnız onaylanan PO kaynağını seçin. Oluşan MO dosyasının adını, yolunu ve değişiklik zamanını kontrol edin; ardından yeni bir WordPress isteğinde bilinen bir tekil ve bir çoğul metni açın. Başarılı işlem iletisi dosyanın üretildiğini gösterir, doğru çevirinin ekranda görünmesi ise WordPress sisteminin o kataloğu yüklediğini kanıtlar.
Dil Derleyici eksik çeviriyi yazmaz, kaynak koddaki yanlış text domain değerini düzeltmez ve güncellemenin eklenti klasöründeki dosyayı ezmesini engelleyemez. Sorun çıkarsa yeni MO dosyasını kaldırıp korunan PO ve MO çiftini geri getirin. Kaynağı, hedefi, yerel ayarı, text domain değerini ve doğrulama sonucunu kaydetmek, derlemenin aynı koşullarda yeniden üretilebilmesini sağlar.
AIOWS Dil Derleyici'yi inceleyinAIOWS planlarını karşılaştırın
İlgili AIOWS yazıları
- WordPress Eklenti Çevirileri Görünmüyor: Nedenler ve Çözümler
- WordPress Dil Dosyaları Nasıl Taranır ve Yönetilir?
- Çok Dilli WordPress Sitesi İçin Önbellek Nasıl Ayarlanır?
Sonuç ve önerilen yol
PO dosyasını bakımın sürdürüldüğü asıl çeviri kaynağı, MO dosyasını ise bu kaynaktan yeniden üretilebilen çalışma zamanı çıktısı olarak değerlendirin. Derlemeden önce text domain, yerel ayar, dosya adı ve yolu doğrulayın; ardından WordPress içinde tekil ve çoğul örneklerle sonucu sınayın.
