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

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

Armenian

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

Ընդհանուր առմամբ կան երեք եղանակներ տողերի թարգմանության համար՝ Translate կոմպոնենտը, useTranslation հուկը կամ translateEntries օգտակար գործիքը:

Translate կոմպոնենտի օգտագործումը։
Թարգմանությունները արտածվում են span տարրում և աջակցում են HTML երևակմանը։

import {Translate} from 'tacotranslate/react';

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

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

useTranslation հուկի օգտագործում։
Վերադարձնում է թարգմանությունները որպես պարզ տող։ Օգտակար է, օրինակ, 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 թարգմանությունը պատրաստ լինի, այն կփոխարինի մեքենայական թարգմանությանը և կուղարկվի ամեն անգամ, երբ պահանջեք ձեր տողերի թարգմանություններ։

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

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

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

import {TacoTranslate} from 'tacotranslate/react';

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

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

Ավելին մանրակրկիտ վերահսկողության համար, դուք կարող եք տեղադրել սկզբնաղբյուրներ կոմպոնենտի մակարդակի վրա։

Սրա հասնելու համար դիտարկեք ձեր նախագծում մի քանի TacoTranslate պրովայդեր օգտագործելը:

Խնդրում ենք նկատի ունենալ, որ նույն տեքստը կարող է տարբեր թարգմանություններ ստանալ տարբեր 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 բովանդակության կառավարում