# Addon Localization

- **İngilizce aslı:** https://wiki.facepunch.com/gmod/Addon_Localization
- **Çeviri tarihi:** 2025-09-26

## language.Add

[language.Add](https://gmod.tr/wiki/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](https://gmod.tr/wiki/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](https://gmod.tr/wiki/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/`](https://github.com/Facepunch/garrysmod/tree/master/garrysmod/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/`](https://github.com/Facepunch/garrysmod/tree/master/garrysmod/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/`](https://github.com/Facepunch/garrysmod/tree/master/garrysmod/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](https://www.sublimetext.com/) ile düzenlenmiş böyle bir dil dosyası olan [`spawnmenu.properties`](https://github.com/Facepunch/garrysmod/blob/master/garrysmod/resource/localization/en/spawnmenu.properties) örneği:

```lua
| File | Edit | Selection | Find | View | Goto | Tools | Project | Preferences | Help |
---------------------------------------------------------------------------------------
<>| spawnmenu.properties |_________________________________________________________ + V
 1|                                                                                   H
 2| spawnmenu.content_tab=Spawnlists                                                  H
 3|                                                                                   H
 3| spawnmenu.category.npcs=NPCs                                                      H
 4| spawnmenu.category.addons=Addons                                                  |
 5| spawnmenu.category.weapons=Weapons                                                |
 6| spawnmenu.category.postprocess=Post Process                                       |
 7| spawnmenu.category.your_spawnlists=Your Spawnlists								  |
 8| spawnmenu.category.addon_spawnlists=Addon Spawnlists                              |
 9| spawnmenu.category.games=Games                                                    |
10| spawnmenu.category.browse=Browse                                                  |
11| spawnmenu.category.entities=Entities                                              |
12| spawnmenu.category.vehicles=Vehicles                                              |
13| spawnmenu.category.creations=Creations                                            |
14| spawnmenu.category.dupes=Dupes                                                    |
15| spawnmenu.category.saves=Saves                                                    |
16|
```

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

[Oyunun yerleşik İngilizce yerelleştirmesini burada bulabilirsiniz.](https://github.com/Facepunch/garrysmod/tree/master/garrysmod/resource/localization/en)

İ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`](https://github.com/Facepunch/garrysmod/blob/master/garrysmod/resource/localization/en/community.properties) dosyasıdır.

`.properties` dosyaları ayrıca karakterleri yazmanın [unicode yolunu](https://en.wikipedia.org/wiki/Unicode) da destekler:

```lua
spawnmenu.content_tab=\u0421\u043f\u0438\u0441\u043a\u0438 \u0441\u043e\u0437\u0434\u0430\u0432\u0430\u0435\u043c\u043e\u0433\u043e
```

## Desteklenen diller

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

| Kod | Dil |
|---|---|
| `bg` | Bulgarca |
| `cs` | Çekçe |
| `da` | Danca |
| `de` | Almanca |
| `el` | Yunanca |
| `en` | İngilizce |
| `en-PT` | Korsan İngilizcesi |
| `es-ES` | İspanyolca |
| `et` | Estonca |
| `fi` | Fince |
| `fr` | Fransızca |
| `he` | İbranice |
| `hr` | Hırvatça |
| `hu` | Macarca |
| `it` | İtalyanca |
| `ja` | Japonca |
| `ko` | Korece |
| `lt` | Litvanyaca |
| `nl` | Hollandaca |
| `no` | Norveççe |
| `pl` | Lehçe |
| `pt-BR` | Portekizce (Brezilya) |
| `pt-PT` | Portekizce (Portekiz) |
| `ru` | Rusça |
| `sk` | Slovakça |
| `sv-SE` | İsveççe |
| `th` | Tayca |
| `tr` | Türkçe |
| `uk` | Ukraynaca |
| `vi` | Vietnamca |
| `zh-CN` | Basitleştirilmiş Çince |
| `zh-TW` | Geleneksel Çince |

- [GMod Wiki ana sayfası](https://gmod.tr/wiki)

---

[Tüm sunucular](https://gmod.tr/) · [GmodTR Launcher](https://gmod.tr/launcher) · [Rehber](https://gmod.tr/rehber) · [GMod Wiki](https://gmod.tr/wiki) · [GmodTR nedir?](https://gmod.tr/hakkinda) · [Sunucu ekle](https://gmod.tr/sunucu-ekle) · [Discord](https://discord.gg/gmodtr)

Kaynak: https://gmod.tr/wiki/Addon_Localization
