Փաստաթուղթ՝ 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 թարգմանություններին համեմատ, սակայն դրանք ապահովում են արագ սկզբնական պատասխան։

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

Եթե դուք ձեռքով թարգմանել եք տողը, այդ թարգմանությունները优еться գերակշռում և վերադարձվում են փոխարենը:

Ադամաբն օգտագործում

TacoTranslate նախագծերը պարունակում են այն, ինչ մենք անվանում ենք միջոցներ։ Կարդացեք դրանք որպես մուտքի կետեր, תיקיות կամ խմբեր ձեր տողերի և թարգմանությունների համար։

import {TacoTranslate} from 'tacotranslate/react';

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

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

Ընդարձակ վերահսկողության համար կարող եք սահմանել արմատներ կոմպոնենտի մակարդակում։

Այսը հասնելու համար խորհուրդ է տրվում օգտագործել մի քանի 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}
		/>
	);
}

Վերը նշված օրինակն արտածվելու է որպես պարզ տեքստ։

Սերվերային կողմի ձևավորում