Ç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ı anahtarlaruseTranslations('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
- Panoda projenize gidin
- **"Anahtar Ekle"**ye tıklayın
- Anahtar adını girin (örn.
common.save_button) - Kaynak dil değerini ekleyin (örn. "Kaydet")
- İ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
Bu makale yardımcı oldu mu?