Փաստաթղթեր: TacoTranslate-ի օգտագործում

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

Armenian

Տողերի թարգմանություն

Այս պահին տեքստերը թարգմանելու երեք եղանակ կա՝ Translate կոմպոնենտը, useTranslation hook-ը կամ 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)
	};
}

Երբ տողերը հասնում են մեր սերվերներին, մենք առաջին հերթին ստուգում ու պահպանում ենք դրանք, ապա անմիջապես վերադարձնում մեքենայական թարգմանություն։ Չնայած մեքենայական թարգմանությունները ընդհանուր առումով որակով զիջում են մեր արհեստական բանականության (AI) թարգմանություններին, դրանք ապահովում են արագ նախնական արձագանք։

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

Եթե դուք տողը ձեռքով թարգմանել եք, այն թարգմանությունները առաջնահերթություն ունեն և դրանք են վերադարձվում։

Աղբյուրների օգտագործում

TacoTranslate նախագծերը պարունակում են այն, ինչ մենք կոչում ենք origins. Կարծեք դրանց որպես մուտքի կետեր, թղթապանակներ կամ ձեր տեքստերի և թարգմանությունների խմբեր։

import {TacoTranslate} from 'tacotranslate/react';

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

Աղբյուրները թույլ են տալիս կազմակերպել տողերը իմաստալից խմբերի մեջ. Օրինակ՝ կարող եք ունենալ մեկ աղբյուր փաստաթղթավորման համար և մեկ այլ՝ ձեր մարքեթինգային էջի համար.

Ավել մանրամասն վերահսկողության համար կարող եք կոմպոնենտի մակարդակում կարգավորել origins-ները։

Դրա հասնելու համար հաշվի առեք ձեր նախագծում մի քանի TacoTranslate պրովայդերներ օգտագործելը։

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

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

Փոփոխականների կառավարում

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

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