Çeviriler

Markdown olarak görüntüle

Blockstudio çevirilerini languages klasöründe sunar. Site dili veya kullanıcı profilindeki dil bunlardan biriyle eşleştiğinde WordPress bu çevirileri kullanır. Bu, Blockstudio bir eklenti, zorunlu kullanım eklentisi veya Composer paketi olarak çalıştırıldığında da aynı şekilde işler.

Kullanılabilir diller

Blockstudio, bölgesel ve resmî/günlük dil biçimleri de dahil olmak üzere, paketlenmiş languages/locales.json içinde kayıtlı WordPress yerel ayarı için çeviriler içerir. İngilizce (en_US) kaynak dildir ve bir çeviri dosyasına ihtiyaç duymaz. Liste, GlotPress’te WordPress tarafından desteklenen yerel ayarları, WordPress çekirdek çeviri API’sında bulunan varyantlarla birleştirir.

Mevcut Almanca (de_DE) ve resmî Almanca (de_DE_formal) çevirileri korunmuştur. Ek çeviriler GPT-6 Luna kullanılarak yapay zekâ tarafından oluşturulmuş ve .po başlıklarında makine üretimi olarak işaretlenmiştir. Otomatik tamlık ve biçim denetimlerinden geçerler, ancak hepsi ana dili konuşan kişilerce gözden geçirilmemiştir. Düzeltmeler memnuniyetle karşılanır.

Çeviriler, blok düzenleyicisindeki alan kontrollerini, yönetici sayfasını, tuvali, devtools katmanını ve REST uç noktalarının mesajlarını kapsar. Kendi block.json dosyalarınızdaki etiketler ve yardım metinleri temanıza veya eklentinize aittir ve onun metin alanını kullanır.

Dili Settings > General > Site Language bölümünden seçin veya WordPress profilinizde kişisel bir dil belirleyin. Blockstudio bu yerel ayarı otomatik olarak kullanır. WordPress dil seçicisine yeni diller eklemez: yerel ayarın WordPress kurulumunuzda da bulunması gerekir. Sitenizde yapay zekâ isteği, çeviri aboneliği veya ek bir çalışma zamanı ayarı gerekmez.

Bir çeviriyi geçersiz kılma

wp-content/languages/plugins içindeki çeviri dosyaları, PHP dizeleri (blockstudio-de_DE.mo veya blockstudio-de_DE.l10n.php) ve betikler (her betik tanıtıcısı için bir dosya; örneğin blockstudio-de_DE-blockstudio-blocks.json) için paketlenmiş dosyalara öncelik tanır.

Çeviriye katkıda bulunun

Her dil, herhangi bir metin düzenleyiciyle veya Poedit gibi bir çeviri aracıyla düzenleyebileceğiniz bir .po dosyasıdır. Düzeltmeler ve yeni diller için pull request’ler memnuniyetle karşılanır.

Dil eklemek için languages/blockstudio.pot dosyasını languages/blockstudio-<locale>.po konumuna kopyalayın; örneğin blockstudio-fr_FR.po. Ardından Language ve Plural-Forms başlıklarını ayarlayın. Bir dili iyileştirmek için mevcut .po dosyasını düzenleyin.
Dizeleri çevirin. Çeviride %1$s gibi yer tutucuları koruyun.
npm run i18n komutunu çalıştırın. Bu komut, WordPress tarafından yüklenen .mo, .l10n.php ve .json dosyalarını yazar.
.po dosyasını oluşturulan dosyalarla birlikte kaydedin ve bir pull request açın.

npm komutunu çalıştıramıyorsanız, yalnızca .po dosyasını içeren bir pull request de uygundur. Oluşturulan dosyalar birleştirme öncesinde eklenebilir.

Eksik çevirileri oluşturma

Bakımcılar, kimlik doğrulaması yapılmış bir Codex CLI ile eksik girdiler oluşturabilir. Bu isteğe bağlı bir geliştirme komutudur; WordPress tarafından çalıştırılmaz:

Kabuk

npm run i18n:translate -- --dry-run
npm run i18n:translate

Varsayılan model gpt-6-luna‘dır. Tek bir yerel ayarda çalışmak için npm run i18n:translate -- --locale fr_FR kullanın. Komut en güncel kaynak dizeleri çıkarır, eksik çevirileri tamamlar, ardından .mo, .l10n.php ve betik başına .json dosyalarını derler. Codex’a yalnızca herkese açık arayüz dizeleri, bunların bağlamı ve mevcut biçimler gönderilir; site içeriği veya kullanıcı verileri gönderilmez.

Mevcut, boş olmayan çevirilerin üzerine asla yazılmaz. Tamamlanan gruplar kaydedilir; böylece kesinti sonrasında komutu yeniden çalıştırmak eksik işleri sürdürür. %1$s, HTML biçimlendirmesi, teknik tanımlayıcılar ve gerekli çoğul biçimleri kaydetmeden önce doğrulanır. Bulanık girdiler ve değişen kaynak çoğul biçimleri, çevirmenin incelemesine bırakılır. İstenen model kullanılamıyorsa yedek bir model kullanılmaz.

npm run i18n:locales, yerel ayar listesini ve çoğul kurallarını WordPress/GlotPress’ten açıkça yeniler. npm run i18n:coverage, depoda tutulan listedeki her yerel ayarın eksiksiz olduğunu denetler. Ne kapsam denetimleri ne de normal CI, yapay zekâyı çağırır veya yerel ayar verilerini getirir. Gruplama, eşzamanlılık ve kurtarma seçenekleri için depo README dosyasına bakın.

Koddaki çevrilebilir dizeler

PHP: blockstudio metin alan adıyla WordPress işlevlerini kullanın; örneğin __( 'Invalid block.', 'blockstudio' ).
JavaScript: @/utils/__ kaynağından __ içe aktarın ve sabit bir metin dizesi iletin; örneğin __( 'Add row' ). Çalışma zamanında oluşturulan bir dize çevrilemez; bu nedenle her varyant için tek bir sabit dize kullanın.
Çevrilebilir dizeler içeren yeni bir betik paketi için scripts/i18n.ts içinde bir kayıt ve aynı tanıtıcı ile Translations::script_path() kullanılarak yapılan bir wp_set_script_translations() çağrısı gerekir.

Dizeleri değiştirdikten sonra npm run i18n komutunu çalıştırın. Bu komut languages/blockstudio.pot ve tüm .po dosyalarını günceller. Bir çevirmen veya npm run i18n:translate bunları tamamlayana kadar yeni dizeler İngilizce kalır. CI, güncel olmayan derlenmiş dosyaları, çıkarım sorunlarını veya eksik yerel ayar kapsamını reddeden npm run i18n:check ve npm run i18n:coverage komutlarını çalıştırır. Oluşturma, bakım sorumlusunun açık bir eylemi olarak kalır.