Hujjatlar: TacoTranslate'dan foydalanish

TacoTranslate'dan foydalanish

Uzbek

Matnlarni tarjima qilish

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

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" 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 utilitadan foydalanish.
Satrlarni 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)
	};
}

Matn qatorlari qanday tarjima qilinadi

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

Bir vaqtning o'zida biz matningiz uchun yuqori sifatli, eng ilg'or sun'iy intellekt tarjimasini yaratish maqsadida asin xron tarjima vazifasini ishga tushiramiz. Sun'iy intellekt tarjimasi tayyor bo'lgach, u mashina tarjimasining o'rnini egallaydi va siz matnlaringiz uchun tarjima so'raganingizda yuboriladi.

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

Manbalardan foydalanish

TacoTranslate loyihalari biz origins deb ataydigan narsalarni o'z ichiga oladi. Ularni sizning 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 ajratish imkonini beradi. Masalan, hujjatlar uchun bitta origin va marketing sahifangiz uchun boshqa origin bo'lishi mumkin.

Batafsilroq 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 originlarda turlicha tarjima qilinishi mumkin.

Oxir-oqibat, matnlarni originlarga qanday ajratishingiz sizning qaroringiz va ehtiyojlaringizga bogʻliq. Biroq, bir origin ichida juda ko'p matn bo'lsa, yuklanish vaqtini uzaytirishi mumkinligini yodda tuting.

O'zgaruvchilar bilan ishlash

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

Satrlardagi 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 uni ko'rsatadi. Ammo, ushbu xulq-atvordan voz kechish uchun useDangerouslySetInnerHTML ni false ga o'rnating.

Ishonchsiz kontentni, masalan foydalanuvchi tomonidan yaratilgan kontentni tarjima qilayotganda HTML-renderingni o‘chirish qatʼiyan tavsiya etiladi.

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