Dokimantasyon: Itilize TacoTranslate

Sèvi ak TacoTranslate

Haitian Creole

Tradui fisèl yo

Gen twa fason pou tradui chenn karaktè kounye a: Komponan Translate, `hook` useTranslation, oswa itilite translateEntries.

Itlizasyon Translate konpozan an.
Soti tradiksyon yo nan yon eleman span, epi 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.
Retounen tradiksyon kòm yon chèn tèks senp. Itil nan, pou egzanp, meta tags yo.

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 itilite translateEntries
Tradui chèn sou 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)
	};
}

Lè chenn karaktè yo rive sou sèvè nou yo, nou premye verifye epi anrejistre yo, epi imedyatman retounen yon tradiksyon machin. Pandan ke tradiksyon machin yo an jeneral mwens bon nan 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 avanse ak kalite siperyè pou chèn karaktè w la. Yon fwa tradiksyon AI a pare, li pral ranplase tradiksyon machin nan epi voye li chak fwa ou mande tradiksyon pou chèn karaktè ou yo.

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

Itlizasyon orijin yo

Pwojè TacoTranslate yo gen sa nou rele orijin. Konsidere yo kòm pwen antre, dosye, oswa gwoup pou string 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 nan bwat 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 detaye, ou ta ka mete orijin yo sou nivo konpozan an.

Pou reyalize sa, konsidere itilize plizyè pwofesè TacoTranslate nan pwojè ou an.

Tanpri note ke menm chèn karaktè a ka resevwa tradiksyon diferan nan diferan orijin.

Nan fen a, jan ou separe chenn yo nan orijin yo depann de ou menm ak bezwen ou genyen. Sepandan, note ke gen anpil chenn 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 imèl, ak plis ankò.

Variab yo 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}});
}

Jesyon kontni HTML

Pa default, konpozan Translate la sipòte epi rann kontni HTML. Sepandan, ou ka chwazi pa itilize konpòtman sa a lè ou mete useDangerouslySetInnerHTML nan false.

Li trè rekòmande pou dezaktive rannman HTML lè w ap tradui kontni ki pa fè konfyans, tankou kontni ki pwodwi pa itilizatè yo.

Tout rezilta toujou fèt tcheke avèk sanitize-html anvan y ap fè rander.

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

Rendisyon bò sèvè

Sèvi ak TacoTranslate

Kijan fisèl yo tradui

Itlizasyon orijin yo

Jere varyab

Jesyon kontni HTML