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

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.

Rande sou bò sèvè

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