Hujjatlar: TacoTranslate'dan foydalanish

TacoTranslate-dan foydalanish

Uzbek

Matnlarni tarjima qilish

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

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" atributidan foydalanib element turini o'zgartirishingiz mumkin.

useTranslation hookdan foydalanish.
Tarjimalarni oddiy satr sifatida qaytaradi. Masalan, meta teglarida foydalidir.

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 utilitidan foydalanish.
Matnlarni server tomonida tarjima qiling. OpenGraph tasvirlaringizni yanada 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 ularni avval tekshirib saqlaymiz, soʻngra darhol mashina tarjimasini qaytaramiz. Mashina tarjimalari odatda sunʼiy intellektimizning tarjimalariga nisbatan sifat jihatidan pastroq boʻlsa-da, ular tezkor boshlangʻich javobni taqdim etadi.

Shu bilan birga, biz matningiz uchun yuqori sifatli, zamonaviy AI tarjimasini yaratish maqsadida asinxron tarjima ishini boshlaymiz. AI tarjimasi tayyor bo'lgach, u mashina tarjimasini almashtiradi va siz satrlaringiz uchun tarjimalarni so'raganingizda yuboriladi.

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

Originlardan foydalanish

TacoTranslate loyihalari biz manbalar deb ataydigan narsalarni o'z ichiga oladi. Ularni satrlaringiz va tarjimalaringiz uchun kirish nuqtalari, papkalar yoki guruhlar sifatida tasavvur qiling.

import {TacoTranslate} from 'tacotranslate/react';

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

Origins sizga matnlarni ma'noli konteynerlarga ajratishga imkon beradi. Masalan, hujjatlar uchun bitta origin, marketing sahifangiz uchun esa boshqa origin bo'lishi mumkin.

Batafsil nazorat uchun originlarni komponent darajasida sozlashingiz mumkin.

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

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

Oxir-oqibat, satrlarni manbalarga qanday ajratishingiz sizga va ehtiyojlaringizga bog‘liq. Biroq, bir manba ichida ko‘p satrlar bo‘lsa, yuklanish vaqti ortishi mumkinligini yodda tuting.

O'zgaruvchilar bilan ishlash

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

Satr ichidagi 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

Odatiy holatda Translate komponenti HTML kontentini qoʻllab‑quvvatlaydi va namoyish qiladi. Biroq, ushbu xulq‑atvordan voz kechmoqchi boʻlsangiz, useDangerouslySetInnerHTMLni falsega oʻrnating.

Ishonchsiz kontentni, masalan foydalanuvchi tomonidan yaratilgan kontentni tarjima qilayotganda, HTML-ni render qilishni 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