TacoTranslate
/
DokimantasyonPri
 
  1. Entwodiksyon
  2. Kòmanse
  3. Konfigirasyon ak enstalasyon
  4. Itilize TacoTranslate
  5. Rendman bò sèvè a
  6. Itilizasyon avanse
  7. Pi bon pratik
  8. Jesyon erè ak débogaj
  9. Lang ki sipòte

Itilize TacoTranslate

Transliteration fisèl

Kounye a gen twa fason pou tradui strings: Konpozan Translate, hook useTranslation, oswa itilite translateEntries.


Itilize konpozan Translate.
Li pibliye tradiksyon yo 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 itilize, pou egzanp, as="p" sou konpozan an.


Itlize useTranslation hook la.
Li retounen tradiksyon kòm yon chèn karaktè senp. Itil pou, pa egzanp, nan 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>
	);
}

Sèvi ak zouti translateEntries la.
Tradui chenn karaktè nan bò sèvè a. Bay imaj OpenGraph ou yo plis 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è chenn teks yo rive nan sèvè nou yo, nou premye verifye epi anrejistre yo, epi imedyatman retounen yon tradiksyon machin. Pandan ke tradiksyon machin yo jeneralman gen pi ba kalite konpare ak tradiksyon AI nou yo, yo bay yon repons inisyal rapid.

An menm tan, nou lanse yon travay tradiksyon asynchrone pou jenere yon tradiksyon AI kalite siperyè, ki dènye kri pou chèn ou a. Yon fwa tradiksyon AI a pare, li pral ranplase tradiksyon machin nan epi li pral voye chak fwa ou mande tradiksyon pou chèn ou yo.

Si ou te tradui yon fisèl manyèlman, tradiksyon sa yo gen priyorite epi yo retounen olye de sa.

Itilize orijin

Pwojè TacoTranslate gen sa nou rele orijin. Panse a yo kòm pwen antre, dosye, oswa gwoup pou chenn karaktè ou yo ak tradiksyon ou yo.

import {TacoTranslate} from 'tacotranslate/react';

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

Orijin yo pèmèt ou separe chenn karaktè yo nan resipyan ki gen sans. Pa egzanp, ou ta ka gen yon orijin pou dokimantasyon ak yon lòt pou paj maketing ou.

Pou plis kontwòl presi, ou ta ka mete orijin yo sou nivo konpozan an.

Pou reyalize sa, konsidere itilize plizyè TacoTranslate founisè nan pwojè ou a.

Tanpri sonje menm fisèl la ka resevwa diferan tradiksyon nan diferan origines.

Finalman, fason ou separe chenn karaktè yo nan orijin yo depann de ou menm ak bezwen ou. Sepandan, sonje ke gen anpil chenn karaktè nan yon sèl orijin ka ogmante tan chajman an.

Jesyon varyab

Ou ta dwe toujou itilize varyab pou kontni dinamik, tankou non itilizatè, dat, adrès imel, ak plis ankò.

Variab yo nan chenn karaktè 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 montre kontni HTML. Sepandan, ou ka dezaktive konpòtman sa a lè w mete useDangerouslySetInnerHTML sou false.

Dekonekte rann HTML la trè rekòmande lè w ap tradui kontni ki pa fè konfyans, tankou kontni ki pwodwi pa itilizatè.

Tout rezilta yo toujou netwaye avèk sanitize-html anvan yo afiche.

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 anlè a ap parèt kòm tèks senp.

Rendman bò sèvè a

Yon pwodwi soti nan NattskiftetFè nan Nòvèj