Փաստաթղթավորում: 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 հուկի օգտագործումը.
Վերադառնում է թարգմանությունները որպես պարզ տող։ Օգտակար է, օրինակ, 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 նախագծերը պարունակում են այն, ինչին մենք անվանում ենք origins. Պատկերացրե՛ք դրանք որպես մուտքային կետեր, թղթապանակներ կամ խմբեր՝ ձեր տողերի եւ թարգմանությունների համար։

import {TacoTranslate} from 'tacotranslate/react';

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

Origins-ները թույլ են տալիս առանձնացնել տողերը իմաստային կոնտեյներներում։ Օրինակ՝ կարող եք ունենալ մեկ origin փաստաթղթավորման համար և մեկ այլ՝ ձեր մարքեթինգային էջի համար։

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