For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/modules/i18n.md (or send Accept: text/markdown).

i18n modülü

Her yüzeyin paylaştığı locale sözleşmesi.

Bu kılavuz hakkında sor

Başlamadan önce

İndirdiğiniz supastack projenizi Visual Studio Code'de Dosya → Klasörü Aç'ı kullanarak açın ve ardından Terminal → Yeni Terminal'i seçin. Depo kökü package.json'u, uygulamaları ve paketleri içeren klasördür. Aşağıdaki komutu orada çalıştırın ve terminalini açık bırakın. Bir komut tanınmazsa devam etmeden önce araç kurulum kılavuzunu tamamlayın.

Önce platform eğitimini okuyun. Sunucu, tarayıcı veya telefon isteklerini yanıtlayan uygulama işlemidir. Web, apps/web/.env.local'yi okur, Expo, apps/mobile/.env.local'yi okur ve veritabanı geçiş komutları root .env'yi okur. Veritabanı olmayan/gösterge paneli gösterimi, Postgres'nin taşınmasını gerektiren gerçek/auth hesaplarından ayrıdır. Yalnızca telefona veya masaüstüne yönelik bir ödeme, ayrı olarak çalışan bir Web arka ucuna ihtiyaç duyar.

corepack pnpm --filter @supastack/web dev

Kurulum ve yapılandırma

packages/i18n, locale kümesine ve çözümleme sözleşmesine sahiptir: SUPPORTED_LOCALES, DEFAULT_LOCALE, LOCALE_COOKIE, isAppLocale, resolveLocale, localePath ve getDictionary. Web rotaları, mobil dizgiler ve işlemsel posta aynı paket üzerinden okur.

Çözümleme sırası yol öneki → çerez → Accept-Language → varsayılan şeklindedir. localePath(locale, path) kanonik href üretir — varsayılan locale için öneksiz, aksi halde /{locale}/… — ve proxy katmanı bunu zorlar.

import { getDictionary, localePath, resolveLocale } from "@supastack/i18n";

const locale = resolveLocale([pathLocale, cookie, acceptLanguage]);
const copy = getDictionary(locale).marketing;

Uygulama iş akışı

Kullanıcıya görünen bir dizgiyi önce sözlük tiplerine, sonra her locale'e ekleyin — çeviri bütünlüğü paketi eksik anahtarlarda ve çevrilmemiş İngilizce metinde başarısız olur.

Ürün mantığını asla locale'e göre dallandırmayın; sözlükler sunumdur. Tarihleri, sayıları ve çoğulları dize şablonları yerine çözümlenmiş locale ile Intl API'leri üzerinden biçimlendirin.

Doğrulama ve sorun giderme

Anahtarlara dokunduktan sonra i18n paket testleri ile site-content bütünlük paketini çalıştırın. Locale önekli bir rotayı, dil değiştiriciyi ve çerez temizlenmiş halde Accept-Language algılamasını puntoda kontrol edin.