CLI'yi nasıl kurar ve projemi nasıl tararım?

Better i18n CLI, çeviri anahtarları için kod tabanınızı tarayan ve bunları panoyla senkronize tutan bir geliştirici aracıdır.

Kurulum

# Bun ile (önerilen)
bun add -g @better-i18n/cli

# npm ile
npm install -g @better-i18n/cli

# pnpm ile
pnpm add -g @better-i18n/cli

Kurulumu doğrulayın:

better-i18n --version

Kimlik doğrulama

Better i18n hesabınızla oturum açın:

better-i18n login

Bu, kimlik doğrulama için bir tarayıcı penceresi açar. Kimlik bilgileriniz yerel olarak ve güvenli şekilde saklanır.

Proje yapılandırması

Proje kök dizininizde bir yapılandırma dosyası oluşturun:

better-i18n init

Bu, better-i18n.config.ts dosyasını oluşturur:

import { defineConfig } from '@better-i18n/cli';

export default defineConfig({
  project: 'acme/dashboard',
  sourceLocale: 'en',
  // Çeviri anahtarları için taranacak dizinler
  include: ['src/**/*.{ts,tsx,js,jsx}'],
  // Hariç tutulacak dizinler
  exclude: ['node_modules', 'dist', '.next'],
});

Kod tabanınızı tarama

Tüm çeviri anahtarlarını bulmak için tarayıcıyı çalıştırın:

better-i18n scan

Tarayıcı şunları algılar:

• t('key') — standart çeviri fonksiyonu çağrıları
• t('namespace:key') — ad alanlı anahtarlar
• useTranslations('namespace') — ad alanı içe aktarmaları
• Şablon değişmezleri: t(`key.${dynamic}`) (dinamik anahtar olarak raporlar)

Tarama çıktısı

Scanning src/**/*.{ts,tsx}...

 Found 142 translation keys in 38 files
   • common: 24 keys
   • auth: 18 keys
   • dashboard: 45 keys
   • settings: 32 keys
   • (default): 23 keys

 ⚠ 3 dynamic keys detected (review manually)

Panoya senkronize etme

Taranan anahtarları Better i18n'e gönderin:

better-i18n sync

Bu işlem:

1. Yerel anahtarları pano ile karşılaştırır
2. Henüz mevcut olmayan yeni anahtarlar oluşturur
3. Panoda olan ama kodda olmayan anahtarları raporlar (potansiyel ölü anahtarlar)

Senkronizasyon durumunu kontrol etme

Her şeyin senkronize olduğunu doğrulayın:

better-i18n check

✓ 142 keys in sync
⚠ 3 keys in code but not in dashboard (run sync to fix)
⚠ 5 keys in dashboard but not in code (potential dead keys)

Doctor çalıştırma

Yaygın sorunları teşhis edin:

better-i18n doctor

Bu, yapılandırmanızı, kimlik doğrulamanızı, API bağlantısını ve proje kurulumunu kontrol eder.

CI/CD entegrasyonu

Birleşmeden önce eksik çevirileri yakalamak için CI pipeline'ınıza better-i18n check ekleyin:

# GitHub Actions örneği
- name: Check translations
  run: better-i18n check --strict

--strict bayrağı, herhangi bir anahtar senkronize değilse 1 koduyla çıkar.

Sonraki adımlar

• Next.js SDK'yı kurun
• İlk çeviri anahtarlarınızı ekleyin