TacoTranslate
/
HujjatlarNarxlash
 
  1. Kirish
  2. Boshlash
  3. Sozlash va konfiguratsiya
  4. TacoTranslate dan foydalanish
  5. Server tomonlama render qilish
  6. Kengaytirilgan foydalanish
  7. Eng yaxshi tajribalar
  8. Xatoliklarni boshqarish va tuzatish
  9. Qoʻllab-quvvatlanadigan tillar

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.

Server tomonlama render qilish

Nattskiftet mahsulotiNorvegiyada ishlab chiqarilgan