Hujjatlar: TacoTranslate'dan foydalanish

TacoTranslate'dan foydalanish

Uzbek

Satrlarni tarjima qilish

Hozirda matnlarni tarjima qilishning uchta yo'li mavjud: Translate komponenti, useTranslation hook'i, yoki translateEntries vositasi.

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

import {Translate} from 'tacotranslate/react';

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

Masalan, komponentda as="p" dan foydalanib element turini o'zgartirishingiz mumkin.

useTranslation hookidan foydalanish.
Tarjimalarni oddiy matn sifatida qaytaradi. Masalan, meta teglarida foydali.

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

Matnlar serverlarimizga yetib kelganda, biz avvalo ularni tekshirib va saqlaymiz, so'ng darhol mashina tarjimasini qaytaramiz. Mashina tarjimalari odatda bizning AI tarjimalarimizga nisbatan sifat jihatidan pastroq bo'ladi, biroq ular tezkor dastlabki javobni taqdim etadi.

Bir vaqtning o'zida, biz sizning matn qatoringiz uchun yuqori sifatli, eng zamonaviy AI tarjimasini yaratish maqsadida asinxron tarjima ishini boshlaymiz. AI tarjimasi tayyor bo'lgach, u mashina tarjimasining o'rnini egallaydi va siz matn qatorlaringiz uchun tarjimalarni so'raganingizda yuboriladi.

Agar siz matnni qo'lda tarjima qilgan bo'lsangiz, bu tarjimalar ustunlikka ega bo'ladi va o'rniga qaytariladi.

Originlardan foydalanish

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

import {TacoTranslate} from 'tacotranslate/react';

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

Manbalar satrlarni ma'noli konteynerlarga ajratishga imkon beradi. Masalan, dokumentatsiya uchun bitta manba va marketing sahifangiz uchun boshqa manba bo'lishi mumkin.

Batafsilroq nazorat uchun originlarni komponent darajasida sozlashingiz mumkin.

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

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

Oxir-oqibat, matnlarni originlarga qanday ajratishingiz sizga va ehtiyojlaringizga bogʻliq. Biroq, bir origin ichida juda koʻp matn boʻlishi yuklanish vaqtini oshirishi mumkin.

O'zgaruvchilarni boshqarish

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

Satrlardagi o'zgaruvchilar ikkita jingalak 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 tarkibini boshqarish

Odatiy bo'lib, Translate komponenti HTML mazmunini qo'llab‑quvvatlaydi va ko'rsatadi. Biroq, bu xulq‑atvordan voz kechish uchun useDangerouslySetInnerHTML ni false ga o'rnatishingiz mumkin.

Ishonchsiz kontentni, masalan foydalanuvchilar tomonidan yaratilgan kontentni tarjima qilayotganda, HTML-renderlashni o‘chirib qo‘yish qat'iyan tavsiya etiladi.

Barcha chiqishlar har doim sanitize-html bilan 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