better-i18n.com
Geliştirici DokümanlarıYardım MerkeziSürüm Notları

İlk projemi nasıl oluştururum?

Güncellendi: Aug 21, 2026Ali Osman Delişmen

Bir proje; tek bir uygulama ya da sitenin anahtarlarını, dillerini ve ayarlarını tutar. Oluşturmak bir dakika sürer; doğru yapılması gereken iki şey kaynak dil ve anahtarınızın nerede duracağıdır.

Oluşturun #

  1. app.better-i18n.com adresinden giriş yapın
  2. New Project
  3. Ad verin — bu ad projenin slug'ı olur, kısa tutun
  4. Kaynak dili seçin: kodunuzun yazıldığı dil
  5. Çevirmek istediğiniz dilleri ekleyin
  6. Create

Projenizi oluşturun — bir ad girin ve kaynak dilinizi seçin

Üzerine düşünülmesi gereken tek seçim kaynak dildir. Her çeviri ondan üretilir ve her anahtarın özgün metni onda yaşar. Sonradan Settings → CDN'den değiştirebilirsiniz, ama her şeyin referans noktası odur; o yüzden gerçekten yazdığınız dille başlayın.

Hedef dilleri değiştirmek ucuzdur — Languages sayfasından istediğiniz zaman ekleyip çıkarın.

Proje tanımlayıcınız #

Her proje org/project biçiminde adreslenir — acme/dashboard. Bunu SDK yapılandırmanıza, CLI yapılandırmanıza ve her API çağrısına yazacaksınız.

API anahtarı oluşturun #

Settings → API Keys → Create Key.

Create API Key — anahtarınıza bir ad verin ve Create Key'e tıklayın

Altı ay sonra tanıyacağınız bir ad verin ("CI", "local dev") ve bir süre seçin: 3 ay, 6 ay, 1 yıl ya da hiç. Liste her anahtarın ne kadar ömrü kaldığını gösterir ve bir tanesinin süresi dolmaya bir ay kala sizi uyarır — CI'da sessizce ölen bir anahtar, kötü geçen bir öğleden sonra demektir.

Anahtar yalnızca bir kez gösterilir. Göründüğünde kopyalayın; bir daha okuyamazsınız, yalnızca değiştirebilirsiniz.

Hangi anahtar nereye #

OkumaYazmaTarayıcıda güvenli
CDN / dağıtım anahtarı✓—✓
API anahtarı✓✓Hayır

CDN anahtarı yalnızca yayınlanmış çevirileri çeker; bunlar ziyaretçilerinizin zaten indirdiği herkese açık verilerdir. API anahtarı projenizi değiştirebilir, dolayısıyla yeri bir sunucu ortam değişkeni ya da CI gizli anahtarlarıdır — asla istemci tarafı kodda ve asla commit edilmiş bir dosyada değil.

Gizli bir anahtar herkese açık bir yere düşerse: API Keys sayfasından iptal edin ve yenisini oluşturun. İptal anında geçerlidir.

Uygulamanızı ona yönlendirin #

Bash
# .env
BETTER_I18N_PROJECT=acme/dashboard
BETTER_I18N_API_KEY=...
TypeScript
// Tam çağrı çatınıza göre değişir — SDK rehberine bakın
const i18n = createI18n({
  project: "acme/dashboard",
  defaultLocale: "en",
});

Sırada ne var #