Çeviriler (i18n)

Çeviriler (i18n olarak da bilinir), temanızın metnini farklı dillerde göstermek demektir. İyi haber: Pano tema çekirdeği zaten tam çevirilerle gelir, bu yüzden yalnızca gerçekten değiştirdiğiniz parçaları yazarsınız.

Nasıl çalışır

Tema çekirdeği, bugün desteklediği diller için tam çevirilerle gelir — en-US (İngilizce), tr (Türkçe) ve ru (Rusça). Bu büyük dosyaları kopyalamaz veya bakımını yapmazsınız.

Bunun yerine temanız yalnızca farklılıkları, her dil için bir dosya olacak şekilde lang-overrides/ adlı bir klasörde taşır:

lang-overrides/
├─ en-US.json
├─ tr.json
└─ ru.json

bun run sync çalıştırdığınızda Pano, override'larınızı tema çekirdeğinin çevirilerinin üzerine birleştirir. Birleştirme eklemelidir: yepyeni metin ekleyebilir veya mevcut metni değiştirebilirsiniz, ancak asla bir tema çekirdeği anahtarını kaybedemezsiniz. Belirtmediğiniz her şey tema çekirdeğinin varsayılanını korur.

Yani işiniz küçüktür: yalnızca değiştirmek veya eklemek istediğiniz anahtarları yazın.

Örnek 1 — Mevcut metni değiştirme

Diyelim ki alt bilginin (footer) Türkçe'de farklı bir şey söylemesini istiyorsunuz. Tema çekirdeğinin dosyalarına dokunmanıza gerek yok — yalnızca o tek anahtarı override edersiniz.

lang-overrides/tr.json dosyasını oluşturun (ya da daha önce oluşturduysanız açın) ve değiştirmek istediğiniz anahtarı ekleyin:

{
  "footer": {
    "copyright": "Benim harika sunucum tarafından yapıldı"
  }
}

bun run sync sonrasında Türkçe ziyaretçiler orada sizin metninizi görür, diğer tüm footer anahtarları ise tema çekirdeğinden dokunulmadan gelir. Aynı etiketi İngilizce'de değiştirmek için onu en-US.json dosyasına da ekleyin; Rusça'da değiştirmek için ru.json dosyasına ekleyin.

Örnek 2 — Yepyeni bir anahtar ekleme

Kendi markup'ınızı eklediyseniz — diyelim ki override ettiğiniz bir görünümde bir kahraman sloganı (hero slogan) — bunun için yeni bir çeviri anahtarı ekleyebilirsiniz.

1. Anahtarı görünümünüzde kullanın. .svelte dosyanızda $_, temanızın ad alanı (namespace) içindeki bir anahtarı arar:

<h1>{$_("my-theme.hero-slogan")}</h1>

2. Anahtarı her dil için lang-overrides/ içinde ekleyin:

// lang-overrides/en-US.json
{
  "my-theme": {
    "hero-slogan": "Your adventure starts here"
  }
}

// lang-overrides/tr.json
{
  "my-theme": {
    "hero-slogan": "Maceran burada başlıyor"
  }
}

// lang-overrides/ru.json
{
  "my-theme": {
    "hero-slogan": "Твоё приключение начинается здесь"
  }
}

Artık slogan, ziyaretçinin dilinde otomatik olarak gösterilir. Birleştirmenin bunları alması için anahtarları ekledikten sonra bun run sync çalıştırın.

Yepyeni bir dil eklemek

Yerleşik üç dille sınırlı değilsiniz. Yeni bir dil eklemek için — örneğin Almanca — lang-overrides/ içine yeni bir dosya oluşturun:

lang-overrides/
└─ de.json

Dosya adı, locale kodudur. de.json demek locale kodu de demektir, en-US.json ise en-US — .json'dan önceki kısım koddur ve en-US, tr, de gibi kodlarla aynı biçimdedir (küçük harfli bir dil kodu, isteğe bağlı olarak tire ve büyük harfli bölge kodu). Çevirilerinizi diğer dosyalarla aynı anahtar yapısını kullanarak içine yazın.

bun run sync sonrasında yeni diliniz tema çekirdeğinin İngilizce çevirileri üzerine inşa edilir — yani henüz çevirmediğiniz her anahtar, ham anahtar göstermek yerine İngilizceye geri düşer.

Hangi dillerin var olduğuna panel karar verir

Dosyayı eklemek tek başına dili sitenizde göstermez. Kullanılabilir dillerin listesi Pano'nun kendisinden gelir: önce bir yöneticinin panelde aynı locale koduna sahip bir locale (örneğin de) tanımlamış olması gerekir. O locale panel tarafında var olduğunda ziyaretçiler onu seçebilir ve de.json çevirileriniz kullanılır. Panelde eşleşen bir locale tanımlı değilse dosya yok sayılır.

Çeviri mi eksik?

Bir anahtarın çevirisi yoksa, gerçek metin yerine ekranda ham anahtar adı (örneğin my-theme.hero-slogan) görünür — sorunu fark etmenin kolay bir yolu. bun run check ayrıca görünümlerinizin kullandığı ama çevrilmemiş anahtarlar hakkında sizi uyarır, böylece bunları göndermeden önce yakalarsınız. Bkz. Paketleme.

Sırada ne var

• Derleme ve Paketleme — temanızı derleyin, denetleyin ve paketleyin.
• Yayınlama ve Premium — temanızı başkalarıyla paylaşın.