TacoTranslate
/
ՓաստաթղթերԳնագոյացում
 
  1. Ներածություն
  2. Սկսում ենք
  3. Սահմանում և կարգավորում
  4. Տարբերակում TacoTranslate-ի օգտագործումը
  5. Սերվերային կողմի արտապատկերում
  6. Առաջադեմ օգտագործում
  7. Լավագույն փորձառություններ
  8. Տվյալների սխալների կառավարում և շտկում
  9. Աջակցվող լեզուներ

Տարբերակում TacoTranslate-ի օգտագործումը

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

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

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

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

Ապրանքների օգտագործում

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

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}
		/>
	);
}

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

Սերվերային կողմի արտապատկերում

Ապրանք՝ Nattskiftet-իցԿատարված է Նորվեգիայում