← Kavramlar

Token keşfi

"Belirteç keşfi", SDK'nın neyin çevrilmesi gerektiğini arayüzünüzü yazış biçiminizden otomatik olarak anlama yöntemidir. Her biri farklı bir içerik yapısına yönelik dört yapı taşı vardır.

t() — satır içi bir dize

İşin yükünü taşıyan fonksiyon. Kaynak metinle çağırdığınızda geçerli yerel ayar için çevirisini döndürür (o yerel ayar henüz hazır değilse kaynak metnin kendisini). İsteğe bağlı category, ilgili ifadeleri gruplar ve makine çevirisine bağlam olarak iletilir; params ise {placeholders} alanlarını doldurur.

const t = useT();

// t(phrase, category?, params?)
t('Hello, {name}!', 'Greetings', { name });

<Translate> — bir içerik bloğu

Bir işaretleme bölgesini sarmalayın; SDK onu bir içerik bloğuna ayrıştırır — her metin düğümü bir ifade olur — ve her dil değişiminde bloğun tamamını yeniden çevirir. Blok, içeriğinden ve kategorisinden türetilen kararlı bir kimlikle anahtarlanır; böylece aynı blok, yeniden render'larda ve sayfa yenilemelerinde de tanınır.

<Translate category="Home">
  <p>Welcome to our store. Browse the catalog in your language.</p>
</Translate>

<Phrase> — biçimlendirmeli tek bir cümle

Bir cümle satır içi biçimlendirme veya enterpolasyon içerdiğinde <Phrase> onu tek bir çevrilebilir birim olarak tutar — böylece "Merhaba Sarah, 3 öğeniz var" cümlesi parçalara bölünmeden tek bir doğal cümle olarak çevrilir. Parametreleri ve çoğullaştırmayı destekler.

<Phrase category="Cart" params={{ name: 'Sarah', count: 3 }}>
  Hi %name%, you have %count% items in your cart.
</Phrase>

<DontTranslate> — dokunmadan bırakın

Marka adları, kod, tanımlayıcılar, adresler — asla çevrilmemesi gereken bir bölgeyi işaretleyin. translate="no" olarak görüntülenir ve keşif işlemi tarafından tamamen atlanır.

<p>Welcome! <DontTranslate>This sentence always stays in English.</DontTranslate> Thanks for visiting!</p>