Dokimantasyon: Sèvi ak TacoTranslate

Sèvi ak TacoTranslate

Haitian Creole

Tradiksyon chèn karaktè

Kounye a gen twa fason pou tradui chenn karaktè: konpozan Translate, hook useTranslation, oswa zouti translateEntries.

Sèvi ak konpozan Translate.
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 yo kòm yon chèn tèks senp. Itil, pou 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 utilitè translateEntries la.
Tradui chenn karaktè 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 verifye epi sove yo, epi imedyatman retounen yon tradiksyon machin. Tradiksyon machin yo, an jeneral, gen kalite ki pi ba pase tradiksyon AI nou yo; sepandan, yo bay yon repons inisyal rapid.

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

Si ou te tradui yon chenn manyèlman, tradiksyon sa yo gen priyorite e y ap retounen pito.

Sèvi ak orijin

Pwojè TacoTranslate gen sa nou rele orijin. Panse yo tankou pwen antre, katab, oswa gwoup pou chèn tèks 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 tèks yo nan konteyè ki gen sans. Pa egzanp, ou ta ka genyen yon orijin pou dokimantasyon epi yon lòt pou paj maketing ou.

Pou yon kontwòl ki pi granilè, ou ta ka mete orijin yo sou nivo konpozan an.

Pou reyalize sa, konsidere sèvi ak plizyè founisè TacoTranslate nan pwojè ou a.

Tanpri sonje ke menm chenn nan ka resevwa tradiksyon diferan nan diferan orijin.

Finalman, fason ou separe fraz yo an orijin depann de ou menm ak bezwen ou yo. Sepandan, sonje ke genyen anpil fraz 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, adrès imèl, ak plis ankò.

Varyab yo nan chenn yo deklare lè w itilize doub akolad, 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 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 afichaj HTML lè w ap tradwi 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 pral rann kòm tèks senp.

Rann sou sèvè

Sèvi ak TacoTranslate

Kouman chenn tèks yo tradui

Sèvi ak orijin

Jere varyab

Jere kontni HTML