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}
/>
);
}
Վերը բերված օրինակն կցուցադրվի որպես պարզ տեքստ։