İlk çeviri anahtarlarımı nasıl eklerim?

Çeviri anahtarları, kodunuz ile çevirileriniz arasındaki köprüdür. Bunları eklemenin üç yolu vardır.

A Seçeneği: CLI ile kod tabanınızı tarayın (önerilen)

CLI, kodunuzdaki tüm t() çağrılarını otomatik olarak bulur ve Better i18n ile senkronize eder.

# CLI'yi yükleyin
bun add -g @better-i18n/cli

# Oturum açın
better-i18n login

# Projenizi tarayın
better-i18n scan

Tarayıcı şu kalıpları algılar:

• t('key.name') — standart çeviri çağrıları
• t('namespace:key.name') — ad alanlı anahtarlar
• useTranslations('namespace') — ad alanı bildirimleri

Taramadan sonra keşfedilen anahtarları panoya göndermek için better-i18n sync komutunu çalıştırın.

B Seçeneği: Panoda anahtarları manuel olarak ekleyin

1. Panoda projenize gidin
2. **"Anahtar Ekle"**ye tıklayın
3. Anahtar adını girin (örn. common.save_button)
4. Kaynak dil değerini ekleyin (örn. "Kaydet")
5. İsteğe bağlı olarak, çevirmenlerin anahtarın nerede kullanıldığını anlamasına yardımcı olacak bağlam ekleyin

C Seçeneği: MCP ile bir AI kodlama ajanı kullanın

Claude Code, Cursor veya başka bir MCP uyumlu ajan kullanıyorsanız, Better i18n MCP sunucusu anahtarları doğrudan oluşturabilir:

"common.welcome_message anahtarını 'Welcome back!' değeriyle ekle"

Ajan, bunu projenize eklemek için createKeys aracını kullanacaktır.

Anahtar adlandırma en iyi uygulamaları

Kalıp	Örnek	Ne zaman kullanılır
namespace.descriptor	common.save	Paylaşılan UI öğeleri
page.section.element	settings.profile.title	Sayfaya özgü içerik
feature.action	auth.login_button	Özelliğe özgü

İpuçları:

• Hiyerarşi için nokta notasyonu kullanın: settings.profile.title
• İlgili anahtarları gruplamak için ad alanları kullanın: common, auth, dashboard
• Çevirmenlerin amacı bilmesi için belirsiz anahtarlara bağlam ekleyin
• Anahtarları açıklayıcı ama kısa tutun

Anahtarlarınızı doğrulayın

Anahtarları ekledikten sonra her şeyin senkronize olduğunu doğrulamak için better-i18n check komutunu çalıştırın:

better-i18n check
# ✓ 42 keys in sync
# ⚠ 3 keys in code but not in dashboard
# ⚠ 1 key in dashboard but not in code

Sonraki adımlar

• AI ile çevir
• Çevirileri yayınla