Hujjatlash: TacoTranslate dan foydalanish

TacoTranslate-dan foydalanish

Uzbek

Satrlarnini tarjima qilish

Hozirda satrlarni tarjima qilishning uchta usuli mavjud: Translate komponenti, useTranslation hooki yoki translateEntries utilitisi.

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!" />;
}

Siz element turini, masalan, komponentda as="p" yordamida o'zgartirishingiz mumkin.

useTranslation hook’dan foydalanish.
Tarjimalarni oddiy satr 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.
Satrlari 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)
	};
}

Qanday qilib satrlar tarjima qilinadi

Satrlari serverlarimizga yetib kelganda, avvalo ularni tekshirib, saqlaymiz, so‘ng darhol mashina tarjimasini qaytamiz. Mashina tarjimalari odatda AI tarjimalarimizga nisbatan sifat jihatidan pastroq bo‘lsa-da, ular tezkor dastlabki javob beradi.

Bir vaqtning o‘zida, biz sizning satringiz uchun yuqori sifatli, eng zamonaviy AI tarjimasini yaratish uchun asinxron tarjima ishini boshlaymiz. AI tarjimasi tayyor bo‘lgach, u mashina tarjimasining o‘rnini bosadi va siz satrlaringiz uchun tarjimalarni so‘raganingizda yuboriladi.

Agar siz matnni qoʻlda tarjima qilgan boʻlsangiz, ushbu tarjimalar ustunroq hisoblanadi va oʻrniga qaytariladi.

Manbalarni ishlatish

TacoTranslate loyihalarida biz origins deb ataydigan narsalar mavjud. Ularni sizning 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 satrlarni ma'noli konteynerlarga ajratishga imkon beradi. Masalan, sizda hujjatlar uchun bitta origin va marketing sahifangiz uchun boshqa origin bo‘lishi mumkin.

Batafsil boshqaruv uchun, originlarni komponent darajasida sozlashingiz mumkin.

Buni amalga oshirish uchun, loyihangizda bir nechta TacoTranslate provayderlaridan foydalanishni ko‘rib chiqing.

Iltimos, shuni yodda tutingki, bir xil satr turli originsda turlicha tarjimalarni olishi mumkin.

Oxir-oqibat, matnlarni originlarga qanday ajratishingiz sizga va sizning ehtiyojlaringizga bog‘liq. Biroq, bir origin ichida ko‘p matnlar bo‘lishi yuklanish vaqtini oshirishi mumkinligini yodda tuting.

O‘zgaruvchilarni boshqarish

Dinamik mazmun uchun, masalan, foydalanuvchi nomlari, sanalar, elektron pochta manzillari va boshqalar uchun doimo o‘zgaruvchilarni ishlatishingiz kerak.

O'zgaruvchilar satrlarda juft qavslar 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 holatda, Translate komponenti HTML kontentini qo‘llab-quvvatlaydi va chiqaradi. Biroq, siz bu xatti-harakatdan chetlasangiz bo‘ladi, buning uchun useDangerouslySetInnerHTML ni false ga o‘rnatishingiz kerak.

Foydalanuvchi tomonidan yaratilgan kabi ishonchsiz kontentni tarjima qilayotganda HTML renderingini o‘chirish qat’iyan tavsiya etiladi.

Barcha chiqishlar har doim sanitize-html bilan tozalangan holda chiqarilishidan oldin tayyorlanadi.

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 rendering