Dokimantasyon: Sèvi ak TacoTranslate

Sèvi ak TacoTranslate

Haitian Creole

Tradui chèn karaktè

Kounye a gen twa fason pou tradui chenn karaktè yo: Konpozan Translate, hook useTranslation, oswa itilite translateEntries.

Sèvi ak konpozan Translate.
Li afiche tradiksyon yo nan 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.

Sèvi ak useTranslation hook la.
Retounen tradiksyon kòm yon chèn tèks senp. Itil, 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 translateEntries itilite.
Tradui chenn karaktè sou bò sèvè a. Amelyore anpil imaj OpenGraph ou yo.

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 yo rive sou sèvè nou yo, nou premye verifye yo epi sove yo, epi imedyatman retounen yon tradiksyon machin. Menm si tradiksyon machin yo anjeneral pi ba nan kalite konpare ak tradiksyon AI nou yo, yo bay yon repons inisyal rapid.

An menm tan, nou lanse yon travay tradiksyon asenkron pou jenere yon tradiksyon AI kalite-wo, pi avanse pou chèn ou a. Lè tradiksyon AI a pare, li pral ranplase tradiksyon machin lan epi li pral voye li chak fwa ou mande tradiksyon pou chenn ou yo.

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

Sèvi ak orijin yo

Pwojè TacoTranslate genyen sa nou rele orijin. Konsidere yo kòm pwen antre, katab, oswa gwoup pou chenn tèks ou ak tradiksyon ou.

import {TacoTranslate} from 'tacotranslate/react';

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

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

Pou yon kontwòl ki pi presi, ou ta ka mete origins sou nivo konpozan an.

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

Tanpri sonje ke menm chèn tèks la ka resevwa tradiksyon diferan selon orijin yo.

Finalman, kijan ou separe chenn tèks yo an orijin depann de ou menm ak bezwen ou. Sepandan, sonje ke genyen anpil chenn tèks nan yon sèl orijin ka ogmante tan chajman.

Jere varyab

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

Varyab yo nan chèn yo deklare lè w itilize doub brakè, 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 defo, konpozan Translate la sipòte epi rann kontni HTML. Sepandan, ou ka dezaktive konpòtman sa a pa mete useDangerouslySetInnerHTML sou 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 yo toujou netwaye ak 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 anwo a ap parèt kòm tèks plenn.

Afichaj sou sèvè

Sèvi ak TacoTranslate

Kijan chèn tèks yo tradui

Sèvi ak orijin yo

Jere varyab

Jere kontni HTML