Addon Localization

language.Add

language.Add, kullanıcının o anda seçili olan dili için bir yerelleştirme dizesi ekler. Bu genellikle bir geliştirici aracı olarak veya sadece tek bir dil kullanan eklentiler için kullanılır. Bu yöntem, birden fazla dil için yerelleştirme dizeleri eklemek istiyorsanız uygun değildir.

Kullanıcının mevcut dili gmod_language konsol değişkeninde saklanır.

language.GetPhrase

language.GetPhrase, çevrilmemiş "dahili" bir dize verildiğinde çevrilmiş bir dizeyi almanızı sağlar.

Çoğu yerde, "#your.string" şeklinde de yazabilirsiniz; eğer bunun için bir çeviri mevcutsa, bu çevrilmiş dize olarak işlenecektir. Bu yöntem bir alt dize olarak çalışmaz - işte bu noktada language.GetPhrase işe yarar.

.properties dosyaları

.properties dosyaları, geliştiricilerin eklentileri birden fazla dil için yerelleştirmesine yardımcı olur. Bu, Garry's Mod'un kullandığı sistemle aynıdır. Dil dosyaları, kullanıcının o anda seçili olan diline göre otomatik olarak yüklenecektir. İngilizce (en) dosyaları, olası eksik çevirileri doldurmak amacıyla diğer tüm dillerden önce yüklenir.

Bu sistemi eklentiniz için kurmak çok basittir. Yapmanız gereken, eklentinizin resource/localization/ klasöründe .properties dosyaları oluşturmaktır. Dosya ve klasör yapısı, ana oyunun kullanımını takip etmelidir, ki bu da aşağıdaki gibidir:

• resource/localization/ klasörü, eklentinizin desteklediği her dil kodu için klasörler içermelidir. Bu, bu sayfanın altındaki önceden tanımlanmış listeden herhangi bir sayıda dil olabilir.
• Bir dil klasörünün içinde - örneğin, resource/localization/en/ - anahtar-değer çiftleri formatında çeviriler içeren .properties dosyaları oluşturmalısınız. Dosya adı herhangi bir şey olabilir, ancak ideal olarak eklentinizin adını temsil etmeli, benzersiz olmalı (dosya sistemi sanal alanda çalışmaz ve bu nedenle tüm eklentiler arasında paylaşılır) ve genellikle eklentinizdeki tüm dillerde aynı olmalıdır.

Bu .properties dosyalarının formatı çok basittir:

• # ile başlayan satırlar yorumdur.
• Her satır, anahtarlar ve değerler = işareti ile ayrılmış tek bir dize olarak ele alınır.
• Anahtarı içeren kısım ( = işaretinden önce ) boşluk içermemelidir.
• İlk satır şu anda hiçbir şey içermeyecek şekilde boş bırakılmalıdır.

İşte sublime text ile düzenlenmiş böyle bir dil dosyası olan spawnmenu.properties örneği:

Örnek olarak, bunlar oyunda "#spawnmenu.content_tab" veya language.GetPhrase( "spawnmenu.content_tab" ) şeklinde kullanılabilir.

Oyunun yerleşik İngilizce yerelleştirmesini burada bulabilirsiniz.

İlgi çekici olan, Garry's Mod topluluğu tarafından sıkça kullanılan ve oyunun desteklediği her dile sizin için çevrilmiş bir dizi kelime içeren community.properties dosyasıdır.

.properties dosyaları ayrıca karakterleri yazmanın unicode yolunu da destekler:

Desteklenen diller

Aşağıda desteklenen dillerin tam bir listesini bulacaksınız: