Diller ve çeviri
Benzer adları paylaşan üç farklı dil kavramı vardır. Bunları ayrı tutmak çeviri hatalarının çoğunu önler.
1. Arayüz dili
API hata metinlerinin ve belgelerin dili. URL'de (/api/v1/{locale}/...) veya MCP oturumunda bulunur. Saklanan içeriği değiştirmez.
2. İçerik dili
Bir tasarım belgesinde hangi çeviri katmanını okuyacağınızı veya yazacağınızı belirler. Sayfa, bileşen ve chrome okuma/yazmalarında contentLocale gönderin. Katmanlar seyrektir: yalnızca değişen yapraklar saklanır.
Yerelleştirme anahtarları blockId:leaf:path biçimindedir. Kök alanlar blok kimliği önekini kullanmaz. save_localization ortak düzeni değiştirmeden katman yazar; get_localization bir dilin boşluklarını raporlar.
3. Yerelleştirilmiş kayıt değerleri
Bir nesne kaydında dil başına alan değerleri; save_entry üzerinde localizedValuesByLocale olarak gönderilir. İkisine de "çeviri" denmesine rağmen sayfa katmanlarıyla ilgisi yoktur.
Etkin diller
Site dilleri birincil dili ve etkin kümeyi tanımlar. Bir sayfanın dil başına farklı yolu olabilir ve yeni eklenen dil, yolunun 404 vermemesi için birincil dilin başlığının kopyasını alır.
Yerelleştirilmiş tanımlayıcılar
Bir nesne türünün yerelleştirilebilir tanımlayıcısı varsa her dil kendi genel bölümünü alır. Bölümü veya tanımlayıcı alanını değiştirmek dil kapsamlı bir 301 yazar.