TacoTranslate dan foydalanish
Matnlarni tarjima qilish
Hozirda matnlarni tarjima qilishning uchta usuli mavjud: Translate
komponenti, useTranslation
xuki yoki translateEntries
utilitisi.
Translate
komponentidan foydalanish.
Tarjimalarni span
elementi ichida chiqaradi va HTML ni ko‘rsatishni qo‘llab-quvvatlaydi.
import {Translate} from 'tacotranslate/react';
function Page() {
return <Translate string="Hello, world!" />;
}
Masalan, komponentda as="p"
yordamida element turini o'zgartirishingiz mumkin.
useTranslation
hook’idan foydalanish.
Tarjimalarni oddiy matn sifatida qaytaradi. Masalan, meta
teglarida foydalidir.
import {useEffect} from 'react';
import {useTranslation} from 'tacotranslate/react';
function Page() {
const helloWorld = useTranslation('Hello, world!');
useEffect(() => {
alert(helloWorld);
}, [helloWorld]);
return (
<title>{useTranslation('My page title')}</title>
);
}
translateEntries
utilitasidan foydalanish.
Qatorlarni server tomonida tarjima qiling. OpenGraph tasvirlaringizni kuchaytiring.
import {createEntry, translateEntries} from 'tacotranslate';
async function generateMetadata(locale = 'es') {
const title = createEntry({string: 'Hello, world!'});
const description = createEntry({string: 'TacoTranslate on the server'});
const translations = await translateEntries(
tacoTranslate,
{origin: 'opengraph', locale},
[title, description]
);
return {
title: translations(title),
description: translations(description)
};
}
Qatorlar qanday tarjima qilinadi
Satırlar serverlarimizga yetib borganda, avvalo ularni tekshirib, saqlaymiz, so‘ng darhol mashina tarjimasini qaytaramiz. Mashina tarjimalari odatda AI tarjimalarimizga nisbatan sifat jihatidan pastroq bo‘lsa-da, ular tezkor dastlabki javob beradi.
Bir vaqtning o‘zida, biz sizning matningiz uchun yuqori sifatli, eng zamonaviy AI tarjimasini yaratish maqsadida asenkron tarjima ishini boshlaymiz. AI tarjimasi tayyor bo‘lgach, u mashina tarjimasining o‘rnini egallaydi va siz tarjimalarni so‘raganingizda yuboriladi.
Agar siz matnni qoʻlda tarjima qilgan boʻlsangiz, shu tarjimalar ustunlikka ega boʻlib, ular qaytariladi.
Manbalarni foydalanish
TacoTranslate loyihalarida biz origins deb ataydigan narsalar mavjud. Ularni o‘z satrlaringiz va tarjimalaringiz uchun kirish nuqtalari, papkalar yoki guruhlar deb o‘ylang.
import {TacoTranslate} from 'tacotranslate/react';
function Menu() {
return (
<TacoTranslate origin="application-menu">
// ...
</TacoTranslate>
);
}
Origins sizga matnlarni mazmunli konteynerlarga ajratish imkonini beradi. Masalan, hujjatlar uchun bitta origin, marketing sahifangiz uchun esa boshqasi bo‘lishi mumkin.
Yanada nozik boshqaruv uchun, siz komponent darajasida originlarni sozlashingiz mumkin.
Buning uchun loyihangizda bir nechta TacoTranslate provayderlaridan foydalanishni ko'rib chiqing.
Iltimos, shuni yodda tutingki, bir xil satr turli originslarda turlicha tarjimalar olishi mumkin.
Nihoyat, satrlarni manbalarga qanday ajratishingiz sizga va sizning ehtiyojlaringizga bog‘liq. Biroq, bitta manbada ko‘p satrlar bo‘lishi yuklanish vaqtini oshirishi mumkinligini unutmang.
O‘zgaruvchilarni boshqarish
Siz har doim dinamik kontent, masalan, foydalanuvchi ismlari, sanalar, elektron pochta manzillari va boshqalar uchun [variables] dan foydalanishingiz kerak.
Satrlardagi oʻzgaruvchilar ikki qavs ichida eʼlon qilinadi, masalan, {{variable}}
.
import {Translate} from 'tacotranslate/react';
function Greeting() {
const name = 'Juan';
return <Translate string="Hello, {{name}}!" variables={{name}} />;
}
import {useTranslation} from 'tacotranslate/react';
function useGreeting() {
const name = 'Juan';
return useTranslation('Hello, {{name}}!', {variables: {name}});
}
HTML kontentini boshqarish
Standart bo'yicha, Translate
komponenti HTML kontentini qo'llab-quvvatlaydi va ko'rsatadi. Biroq, siz bu xatti-harakatdan voz kechishingiz mumkin, bunda useDangerouslySetInnerHTML
ni false
ga o'rnatasiz.
Ishonchsiz kontent, masalan, foydalanuvchi tomonidan yaratilgan kontentni tarjima qilishda HTML render qilishni o‘chirish qat’iyan tavsiya etiladi.
Barcha chiqishlar har doim chiqarilishdan avval sanitize-html bilan tozalanadi.
import {Translate} from 'tacotranslate/react';
function Page() {
return (
<Translate
string={`
Welcome to <strong>my</strong> website.
I’m using <a href="{{url}}">TacoTranslate</a> to translate text.
`}
variables={{url: 'https://tacotranslate.com'}}
useDangerouslySetInnerHTML={false}
/>
);
}
Yuqoridagi misol oddiy matn sifatida chiqariladi.