Hujjatlar: TacoTranslate-dan foydalanish

TacoTranslate-dan foydalanish

Uzbek

Matnlarni tarjima qilish

Hozirda matnlarni tarjima qilishning uchta usuli mavjud: Translate komponenti, useTranslation hooki yoki translateEntries yordamchi dasturi.

Translate komponentidan foydalanish.
Tarjimalarni span elementida chiqaradi va HTMLni ko‘rsatishni 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’idan foydalanish.
Tarjimalarni oddiy matn sifatida qaytaradi. Masalan, meta teglarda 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 rasmlaringizni super quvvatlang.

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)
	};
}

Satrlari qanday tarjima qilinadi

Matnlar bizning serverlarga yetib kelganda, avval ularni tekshirib, saqlaymiz, so‘ng darhol mashina tarjimasini qaytaramiz. Mashina tarjimalari odatda bizning AI tarjimalarimizga nisbatan sifat jihatidan pastroq bo‘lsa-da, ular tezkor dastlabki javob beradi.

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

Agar siz matnni qoʻlda tarjima qilgan boʻlsangiz, ushbu tarjimalar ustunlikka ega boʻlib, ular qaytariladi.

Manbalarni ishlatish

TacoTranslate loyihalarida biz manbalar 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 ajratish imkonini beradi. Masalan, sizda hujjatlar uchun bitta origin va marketing sahifangiz uchun boshqa origin bo‘lishi mumkin.

Yanada nozik nazorat uchun, siz 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 originlarda turlicha tarjimalar olishi mumkin.

Oxir-oqibat, satrlarni originlarga qanday ajratishingiz sizga va ehtiyojlaringizga bog‘liq. Biroq, bir origin ichida ko‘p satrlar bo‘lsa, yuklanish vaqtlari oshishi mumkinligini yodda tuting.

O‘zgaruvchilarni boshqarish

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

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

Default bo'yicha, Translate komponenti HTML mazmunini qo‘llab-quvvatlaydi va chiqaradi. Biroq, siz bu xatti-harakatdan voz kechishingiz mumkin, bunda useDangerouslySetInnerHTML ni false ga o‘rnatasiz.

Ishtirokchi tomonidan yaratilgan mazmun kabi ishonchsiz mazmunni tarjima qilishda HTML ko‘rsatishni o‘chirish qat’iyan tavsiya etiladi.

Barcha chiqish har doim sanitize-html bilan tozalanadi va keyin ko‘rsatiladi.

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 tomonlama render qilish