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

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

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

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

import {TacoTranslate} from 'tacotranslate/react';

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

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

Ավելին՝ ավելի մանրամասն վերահսկողության համար կարող եք կոմպոնենտի մակարդակում կարգավորել origins-ները։

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

Խնդրում ենք նկատի ունենալ, որ նույն տողը կարող է տարբեր ծագումներում տարբեր թարգմանություններ ստանալ։

Վերջիվերջո, թե ինչպես կբաժանեք տողերը origin-ների մեջ՝ կախված է ձեզնից և ձեր պահանջներից. Այնուամենայնիվ, նկատի ունեցեք, որ շատ տողերի առկայությունը մեկ origin-ում կարող է երկարացնել բեռման ժամանակը։

Փոփոխականների կառավարում

Դինամիկ բովանդակության համար միշտ պետք է օգտագործել փոփոխականներ, օրինակ՝ օգտատերերի անուններ, ամսաթվեր, էլեկտրոնային փոստի հասցեներ և այլն։

Տողերում փոփոխականները հայտարարվում են կրկնակի փակագծերով, օրինակ՝ {{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Արտադրված է Նորվեգիայում