Dokumentatsiya: TacoTranslate’dan foydalanish

TacoTranslate-dan foydalanish

Uzbek

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

Masalan, komponentda as="p" ni ishlatib element turini o'zgartirishingiz mumkin.

useTranslation hook'idan 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.
Matnlarni server tomonida tarjima qiling. Sizning 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)
	};
}

Satrlar qanday tarjima qilinadi

Matnlar bizning serverlarimizga yetib borganda, avval ularni tekshirib va saqlaymiz, so‘ng darhol mashina tarjimasini qaytaramiz. Mashina tarjimalari odatda bizning sun’iy intellekt tarjimalarimizga nisbatan sifat jihatidan pastroq bo‘lsa-da, ular tezkor dastlabki javobni taqdim etadi.

Bir paytning o'zida, biz sizning satringiz uchun yuqori sifatli, zamonaviy sun'iy intellekt tarjimasini yaratish maqsadida asenkron tarjima ishini boshlaymiz. Sun'iy intellekt tarjimasi tayyor bo'lgach, u mashina tarjimasini almashtiradi va siz satrlaringiz uchun tarjima so'raganingizda yuboriladi.

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

Originlardan foydalanish

TacoTranslate loyihalari biz originlar deb ataydigan narsalarni o'z ichiga oladi. Ularni matnlaringiz 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 bitta origin va marketing sahifangiz uchun esa boshqa origin bo'lishi mumkin.

Yanada nozik boshqaruv uchun komponent darajasida originlarni sozlashingiz mumkin.

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

Iltimos, 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 ortishi mumkinligini yodda tuting.

O'zgaruvchilarni boshqarish

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

Satr ichidagi o'zgaruvchilar ikki 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 tarkibini boshqarish

Odatiy holda, Translate komponenti HTML mazmunini qo'llab-quvvatlaydi va chiqaradi. Biroq, ushbu xatti-haraktdan voz kechish uchun useDangerouslySetInnerHTML ni false ga o'rnatishingiz mumkin.

Ishonilmaydigan, masalan, foydalanuvchilar tomonidan yaratilgan kontentni tarjima qilayotganda HTML-renderingni o‘chirib qo‘yish qat’iyan tavsiya etiladi.

Barcha chiqishlar har doim render qilinishdan oldin sanitize-html orqali 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