Dokumentasyon: Itilizasyon TacoTranslate

Lè w ap itilize TacoTranslate

Haitian Creole

Tradui chèn karaktè

Gen kounye a twa fason pou tradui chenn karaktè yo: Konpozan Translate, kwochèt useTranslation la, oswa itilite translateEntries.

Itilize konpozan Translate.
Ap sòti tradiksyon andedan 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, pou egzanp, as="p" sou konpozan an.

Itlizasyon useTranslation hook la.
Retounen tradiksyon kòm yon chèn tèks senp. Itil nan, pa egzanp, meta etikèt 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>
	);
}

Itlilize translateEntries zouti a.
Tradui kòd 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è chèn tèks yo rive nan sèvè nou yo, nou premye valide epi sove yo, epi nou imedyatman retounen yon tradiksyon machin. Pandan ke tradiksyon machin yo anjeneral gen yon kalite ki pi ba konpare ak tradiksyon AI nou yo, yo bay yon repons inisyal rapid.

An menm tan, nou lanse yon travay tradiksyon asenkwòn 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 chenn ou yo.

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

Itlizasyon orijin

Pwojè TacoTranslate yo genyen sa nou rele orijin. Konsidere yo kòm pwen antre, dosye, oswa gwoup pou chenn karaktè 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 kontenè ki gen sans. Pa egzanp, ou ta ka gen yon orijin pou dokimantasyon epi 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.

Tanpri sonje ke menm chèn nan ka resevwa tradiksyon diferan nan orijin diferan.

Finalman, fason ou separe chenn karaktè yo nan orijin yo depann de ou menm ak 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ò.

Variab nan fisèl 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, Translate konpozan an sipòte epi rann kontni HTML. Sepandan, ou ka dezaktive konpòtman sa a lè ou mete useDangerouslySetInnerHTML nan false.

Dezaktive rannman HTML se yon bagay yo rekòmande anpil lè w ap tradui kontni ki pa fè konfyans, tankou kontni ki pwodwi pa itilizatè.

Tout rezilta yo toujou netwaye ak sanitize-html anvan yo parèt.

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.

Randevou bò sèvè a

Lè w ap itilize TacoTranslate

Kijan fisèl yo tradui

Itlizasyon orijin

Jere varyab

Jesyon kontni HTML