TacoTranslate
/
DokimantasyonPri
 
Atik
May 04, 2025

Pi bon solisyon pou entènasyonalizasyon (i18n) nan aplikasyon React

Èske w ap chèche elaji aplikasyon React ou yo nan nouvo mache? TacoTranslate fè li ekstrèmman fasil pou lokalize aplikasyon React ou yo, sa pèmèt ou rive jwenn yon odyans mondyal san okenn tèt chaje.

Poukisa chwazi TacoTranslate pou React?

  • Entegrasyon san pwoblèm: Ki fèt espesyalman pou aplikasyon React, TacoTranslate entegre san efò nan pwosesis travay ou ki egziste deja.
  • Koleksyon otomatik tèks: Pa bezwen jere dosye JSON manyèlman ankò. TacoTranslate kolekte otomatikman tèks yo nan baz kòd ou.
  • Tradiksyon ak entèlijans atifisyèl: Sèvi ak pouvwa entèlijans atifisyèl pou bay tradiksyon ki presi nan kontèks la epi ki adapte ak ton aplikasyon ou a.
  • Sipò lang enstantane: Ajoute sipò pou nouvo lang ak yon sèl klik, sa fè aplikasyon ou aksesib atravè lemond.

Kijan li fonksyone

Enstale pake TacoTranslate la atravè npm:

npm install tacotranslate

Lè ou fin enstale modil la, w ap bezwen kreye yon kont TacoTranslate, yon pwojè tradiksyon, ak kle API ki asosye yo. Kreye yon kont isit la. Li gratis, epi pa mande w pou ajoute yon kat kredi.

Nan koòdone aplikasyon TacoTranslate la, kreye yon pwojè epi ale nan tab kle API li a. Kreye yon kle read epi yon kle read/write. Nou pral sove yo kòm varyab anviwònman. Kle read la se sa nou rele public, epi kle read/write la se secret. Pa egzanp, ou ta ka ajoute yo nan yon dosye .env ki nan rasin pwojè ou a.

Ou pral bezwen tou ajoute de lòt varyab anviwònman: TACOTRANSLATE_DEFAULT_LOCALE ak TACOTRANSLATE_ORIGIN.

  • TACOTRANSLATE_DEFAULT_LOCALE: Kòd lokal defo ki sèvi kòm rezèv. Nan egzanp sa a, n ap mete li sou en pou Anglè.
  • TACOTRANSLATE_ORIGIN: “katab” kote chenn tèks ou yo ap estoke, tankou URL sit wèb ou a. Li plis sou orijin yo isit la.
.env
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

Asire w pou ou pa janm revele kle API sekrè read/write la nan anviwònman pwodiksyon sou bò kliyan an.

Konfigirasyon TacoTranslate

Inisyalize TacoTranslate nan aplikasyon React ou a pa anvlwaye aplikasyon an nan founisè kontèks TacoTranslate la:

import React, {useState} from 'react';
import TacoTranslate, {Translate} from 'tacotranslate/react';

const tacoTranslate = createTacoTranslateClient({
	apiKey: 'YOUR_API_KEY',
});

export default function App() {
	const [locale, setLocale] = useState('en');

	return (
		<TacoTranslate client={tacoTranslate} locale={locale}>
			<Translate string="Hello, world!"/>
		</TacoTranslate>
	);
}

Kounye a ou ka itilize konpozan Translate nenpòt kote nan aplikasyon w lan pou afiche tèks tradui! Asire w pou w tcheke dokumentasyon nou an pou plis enfòmasyon, epi pou gid enplemantasyon ki spesifik pou konfigirasyon ou.

import {Translate} from 'tacotranslate/react';

export default async function Component() {
	return (
		<Translate string="Hello? This is TacoTranslate speaking." />
	);
}

Benefis lè w itilize TacoTranslate

  • Ekonomize tan: Otomatize pwosesis fatigan lokalizasyon ak koleksyon tèks yo, sa pèmèt ou sove tan ki gen anpil valè.
  • Ekonomik: Diminye bezwen pou tradiksyon manyèl, kidonk bese depans lokalizasyon ou.
  • Presizyon amelyore: Tradiksyon ki sipòte pa entèlijans atifisyèl asire rezilta ki presi nan kontèks la epi ki gen bon kalite.
  • Solisyon fasil pou elaji: Ajoute sipò pou nouvo lang fasilman pandan aplikasyon ou ak baz kliyan ou ap grandi.

Kòmanse jodi a!

Aplikasyon React ou a pral tradui otomatikman lè ou ajoute nenpòt chèn tèks nan yon Translate konpozan. Remake ke sèlman anviwònman ki gen pèmisyon read/write sou kle API a ap kapab kreye nouvo chèn pou tradui.

Nou rekòmande pou gen yon anviwònman staging fèmen ak sekirize kote ou ka teste aplikasyon pwodiksyon ou a, epi ajoute nouvo chèn anvan ou ale an dirèk. Sa ap anpeche nenpòt moun vòlè kle API sekrè ou a, epi potansyèlman gonfle pwojè tradiksyon ou a pa ajoute chèn pa otorize.

Be sure to check out the complete examples over at our GitHub profile. If you encounter any problems, feel free to reach out, and we’ll be more than happy to help.

TacoTranslate lets you automatically localize your React applications quickly to and from over 75 languages. Translate for free!

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