Փաստաթղթավորում: 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)
	};
}

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

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

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

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

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

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 բովանդակության կառավարում