Dokumentatsiya: TacoTranslate-dan foydalanish

TacoTranslate'dan foydalanish

Uzbek

Satrlarni tarjima qilish

Hozirda satrlarni tarjima qilish uchun uchta usul mavjud: Translate komponenti, useTranslation hooki yoki translateEntries utilitasi.

Translate komponentidan foydalanish.
Tarjima natijalarini span elementi ichida chiqaradi va HTML-ni render qilishni qo'llab-quvvatlaydi.

import {Translate} from 'tacotranslate/react';

function Page() {
	return <Translate string="Hello, world!" />;
}

Misol uchun, komponentda as="p" yordamida element turini o'zgartirishingiz mumkin.

useTranslation hookdan foydalanish.
Tarjimalarni oddiy matn qatori 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.
Satrlarni server tomonida tarjima qiling. Sizning OpenGraph rasmlaringizni 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)
	};
}

Satrlar qanday tarjima qilinadi

Satrlar serverlarimizga yetib kelganda, avval ularni tekshirib va saqlaymiz, so‘ng darhol mashina tarjimasini qaytaramiz. Mashina tarjimalari odatda bizning AI tarjimalarimizga nisbatan sifat jihatidan pastroq bo‘lsa-da, ular tezkor boshlang‘ich javobni taqdim etadi.

Bir vaqtning o'zida, biz satringiz uchun yuqori sifatli, zamonaviy AI tarjimasini yaratish uchun asin xron tarjima ishini boshlaymiz. AI tarjimasi tayyor bo'lgach, u mashina tarjimasining o'rnini egallaydi va satrlaringiz uchun tarjimalarni so'raganingizda yuboriladi.

Agar siz satrni qo'lda tarjima qilgan bo'lsangiz, ushbu tarjimalar ustun bo'ladi va ular qaytariladi.

Originlardan foydalanish

TacoTranslate loyihalarida biz origins deb ataydigan elementlar mavjud. Ularni sizning stringlaringiz va tarjimalaringiz uchun kirish nuqtalari, papkalar yoki guruhlar deb o'ylang.

import {TacoTranslate} from 'tacotranslate/react';

function Menu() {
	return (
		<TacoTranslate origin="application-menu">
			// ...
		</TacoTranslate>
	);
}

Originlar sizga satrlarni ma'noli konteynerlarga ajratishga imkon beradi. Masalan, hujjatlar uchun bir origin, marketing sahifangiz uchun esa boshqa bir origin bo'lishi mumkin.

Yanada nozik nazorat uchun originlarni komponent darajasida sozlashingiz mumkin.

Bunga erishish uchun, bir nechta TacoTranslate provayderlaridan foydalanishni ko'rib chiqing loyihangizda.

Iltimos, shuni yodda tutingki, bir xil satr turli manbalarda turlicha tarjima qilinishi mumkin.

Oxir-oqibat, satrlarni originlarga qanday ajratishingiz sizga va ehtiyojlaringizga bog'liq. Biroq, bir origin ichida juda ko'p satrlar bo'lsa, yuklanish vaqti oshishi mumkin.

O'zgaruvchilar bilan ishlash

Dinamik kontent uchun har doim o'zgaruvchilardan foydalanishingiz kerak, masalan, foydalanuvchi ismlari, sanalar, elektron pochta manzillari va boshqalar.

Satrdagi o'zgaruvchilar juft qavs yordamida 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

Odatiy bo'yicha, Translate komponenti HTML mazmunini qo'llab‑quvvatlaydi va ko'rsatadi. Biroq, ushbu xatti-harakatdan voz kechish uchun useDangerouslySetInnerHTML ni false ga o'rnatishingiz mumkin.

Ishonchsiz kontentni, masalan foydalanuvchi tomonidan yaratilgan mazmunni tarjima qilishda HTML-ni render qilishni o‘chirib qo‘yish qat’iyan tavsiya etiladi.

Barcha chiqishlar har doim sanitize-html yordamida ko'rsatilishdan oldin 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 ko'rsatiladi.

Server tomonida renderlash