Փաստաթուղթ. Կիրառել TacoTranslate-ը

TacoTranslate-ի օգտագործում

Armenian

Տեքստերի թարգմանություն

Այժմ կան երեք եղանակներ տողերը թարգմանելու համար՝ Translate կոմպոնենտը, useTranslation հուկը, կամ translateEntries օգտակար գործիքը։

Օգտագործելով Translate կոմպոնենտը։
Արտադրում է թարգմանությունները span տարրում և աջակցում է HTML-ի վերապատկերումը։

import {Translate} from 'tacotranslate/react';

function Page() {
	return <Translate string="Hello, world!" />;
}

Դուք կարող եք փոխել էլեմենտի տեսակն, օրինակ՝ օգտագործելով as="p" կոմպոնենտի վրա։

Օգտագործելով useTranslation hook-ը։
Վերադարձնում է թարգմանությունները որպես պարզ տող։ Օգտակար է, օրինակ, meta թեգերում։

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 օգտակար գործիքի օգտագործումը։
Թարգմանեք տողերը սերվերի կողմում։ Եռապատկեք ձեր OpenGraph պատկերները։

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

Երբ շարաները հասնում են մեր սերվերներին, մենք նախապես ստուգում և պահպանում դրանք, այնուհետև անմիջապես վերադարձնում մեքենայական թարգմանություն: Մեքենայական թարգմանությունները իհարկե ընդհանուր առմամբ ցածրորակ են համեմատած մեր ԱԻ թարգմանությունների հետ, բայց դրանք ապահովում են արագ սկզբնական արձագանք:

Միևնույն ժամանակ մենք սկսում ենք ասինխրոն թարգմանության աշխատանք՝ ձեր տողի համար բարձրորակ, ժամանակակից արհեստական ինտելեկտի թարգմանություն ստեղծելու համար։ Կրկնօրինակության թարգմանությունը պատրաստ լինելուց հետո այն կփոխարինի մեքենայական թարգմանությունը և կուղարկվի ցանկացած անգամ, երբ խնդրեք ձեր տողերի թարգմանություններ։

Եթե դուք ձեռքով թարգմանել եք մի շարք, այդ թարգմանությունները նախատարածում են ստացել և փոխարենը վերադարձվում են:

Ծագումները օգտագործելը

TacoTranslate նախագծերը պարունակում են այն, ինչը մենք կոչում ենք բներգություններ: Դրանք դիտարկեք որպես մուտքի կետեր, թղթապանակներ կամ խմբեր ձեր տողերի և թարգմանությունների համար:

import {TacoTranslate} from 'tacotranslate/react';

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

Աղբյուրը ձեզ թույլ է տալիս բաժանել տողերը իմաստուն տարրաների մեջ։ Օրինակ՝ դուք կարող եք ունենալ մեկ աղբյուր փաստաթղթերի համար և մյուսը ձեր մարքեթինգային էջի համար։

Նման մանրամասն կառավարման համար կարող եք սահմանել origins կոմպոնետի մակարդակով։

Այսին հասնելու համար մտածեք ձեր նախագծում շատապայմանափակ TacoTranslate մատակարարների օգտագործման մասին։

Խնդրում ենք նկատի ունենալ, որ նույն տողը կարող է ստացել տարբեր թարգմանություններ տարբեր ծագումներում։

Վերջնական հաշվով, ինչպես եք դուք բաժանում տողերը սկիզբներին՝ կախված է ձեր և ձեր կարիքներից: Այնուամենայնիվ, նկատեք, որ բազմաթիվ տողերի առկայությունը մեկ նույն սկզբում կարող է ավելացնել բեռնման ժամանակը:

Փոփոխականների մշակումը

Դուք պետք է միշտ օգտագործեք փոփոխականներ դինամիկ պարունակության համար, օրինակ՝ օգտատերերի անուններ, ամսաթվեր, էլ․ փոստի հասցեներ և ավելին։

Տողիների փոփոխականները հայտարարվում են երկակի փակագծերով, ինչպես {{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 բովանդակության կառավարում

Դեֆոլտով, Translate կոմպոնենտը աջակցում է և վերահայտնաբերում HTML պարունակությունը։ Այնուամենայնիվ, դուք կարող եք հրաժարվել այս վարքից, նշանակման միջոցով useDangerouslySetInnerHTML որպես false:

HTML-ի ցուցադրումն անջատելը խիստ խորհուրդ է տրվում չվստահելի բովանդակություն թարգմանելիս, օրինակ՝ օգտատերերի կողմից ստեղծված բովանդակություն։

Բոլոր ելքը միշտ սանիտարվում է sanitize-html շաբաթ արտապատկերվելուց առաջ:

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

Վերը նշված օրինակն առնչվի որպես պարզ տեքստ:

Սերվերային կողմի ռենդերинг

TacoTranslate-ի օգտագործում

Ինչպես են թարգմանվում տողերը

Ծագումները օգտագործելը

Փոփոխականների մշակումը

HTML բովանդակության կառավարում