Itilize TacoTranslate
Tradui fisèl
Kounye a gen twa fason pou tradui fisèl yo: Konpozan Translate
, hook useTranslation
, oswa sèvis translateEntries
.
Sèvi ak konpozan Translate
.
Li pwodui tradiksyon anndan yon eleman span
, epi li sipòte rann HTML.
import {Translate} from 'tacotranslate/react';
function Page() {
return <Translate string="Hello, world!" />;
}
Ou ka chanje tip eleman an lè w itilize, pa egzanp, as="p"
sou konpozan an.
Itlize useTranslation
hook la.
Li retounen tradiksyon kòm yon chèn tèks òdinè. Itil nan, pa egzanp, etikèt 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>
);
}
Itlize zouti translateEntries
la.
Tradui fisèl sou bò sèvè a. Bay imaj OpenGraph ou yo yon ogmantasyon pouvwa.
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)
};
}
Kijan chenn yo tradui
Lè chèn karaktè yo rive sou sèvè nou yo, nou verifye epi sove yo an premye, epi imedyatman retounen yon tradiksyon machin. Pandan ke tradiksyon machin yo anjeneral gen yon kalite ki pi ba konpare ak tradiksyon entèlijans atifisyèl nou yo, yo bay yon repons inisyal rapid.
An menm tan, nou lanse yon travay tradiksyon asenkron pou jenere yon tradiksyon AI kalite siperyè, dènye kri pou chenn ou an. Yon fwa tradiksyon AI a pare, li pral ranplase tradiksyon machin nan epi li pral voye chak fwa ou mande tradiksyon pou chenn ou yo.
Si ou te tradui yon fisèl manyèlman, tradiksyon sa yo gen plis enpòtans e se yo ki retounen olye.
Itilize orijin
Pwojè TacoTranslate yo genyen sa nou rele origins. Konsidere yo kòm pwen antre, dosye, oswa gwoup pou chenn tèks ak tradiksyon ou yo.
import {TacoTranslate} from 'tacotranslate/react';
function Menu() {
return (
<TacoTranslate origin="application-menu">
// ...
</TacoTranslate>
);
}
Orijin pèmèt ou separe strings nan resipyan ki gen sans. Pa egzanp, ou ta ka gen yon orijin pou dokimantasyon epi yon lòt pou paj maketing ou.
Pou yon kontwòl plis detaye, ou ta ka mete orijin yo sou nivo konpozan an.
Pou reyalize sa, konsidere sèvi ak plizyè founisè TacoTranslate nan pwojè ou.
Tanpri note ke menm chèn karaktè a ka resevwa diferan tradiksyon nan diferan orijin.
Finalman, kijan ou sepawate chenn karaktè yo nan orijin se yon chwa pou ou menm ak selon bezwen ou yo. Sepandan, sonje ke gen anpil chenn karaktè nan yon sèl orijin ka ogmante tan chajman yo.
Jere varyab
Ou ta dwe toujou itilize varyab pou kontni dinamik, tankou non itilizatè, dat, adrès imel, ak plis ankò.
Varyab nan chenn yo deklare lè l sèvi avèk doub parantèz, tankou {{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}});
}
Jere kontni HTML
Pa default, konpozan Translate
la sipòte epi li rann kontni HTML. Sepandan, ou ka chwazi pa itilize konpòtman sa a pa mete useDangerouslySetInnerHTML
nan false
.
Dezaktive rander HTML la trè rekòmande lè w ap tradui kontni ki pa gen konfyans ladan l, tankou kontni ki pwodwi pa itilizatè yo.
Tout rezilta toujou ap sanitè avèk sanitize-html anvan yo montre.
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}
/>
);
}
Egzanp ki anwo a ap parèt kòm tèks senp.