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

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

Միևնույն ժամանակ մենք սկսում ենք ասինխրոն թարգմանման աշխատանք՝ ձեր տեքստի համար բարձրորակ, ժամանակակից AI-թարգմանություն ստեղծելու համար։ 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 բովանդակության կառավարում