TacoTranslate
/
DokumentacionÇmimet
 
Neni
04 maj 2025

Zgjidhja më e mirë për internacionalizimin (i18n) në aplikacionet React

Po kërkoni të zgjeroni aplikacionin tuaj React në tregje të reja? TacoTranslate e bën jashtëzakonisht të lehtë lokalizimin e aplikacioneve tuaja React, duke ju mundësuar të arrini një audiencë globale pa telashe.

Pse të zgjidhni TacoTranslate për React?

  • Integrim pa probleme: Dizajnuar posaçërisht për aplikacionet React, TacoTranslate integrohet pa përpjekje në rrjedhën tuaj ekzistuese të punës.
  • Mbledhje automatike e teksteve: Mjaft më me menaxhimin manual të skedarëve JSON. TacoTranslate automatikisht mbledh tekstet nga baza e kodit tuaj.
  • Përkthime të fuqizuara nga AI: Përdorni fuqinë e AI për të ofruar përkthime të sakta në kontekst që përshtaten me tonin e aplikacionit tuaj.
  • Mbështetje e menjëhershme për gjuhë: Shtoni mbështetje për gjuhë të reja me vetëm një klikim, duke e bërë aplikacionin tuaj të aksesueshëm globalisht.

Si funksionon

Instaloni paketën TacoTranslate përmes npm:

npm install tacotranslate

Kur të keni instaluar modulin, do t'ju duhet të krijoni një llogari TacoTranslate, një projekt përkthimi, dhe çelësat përkatës të API-së. Krijoni një llogari këtu. Është falas, dhe nuk kërkon që të shtoni një kartë krediti.

Në ndërfaqen e aplikacionit TacoTranslate, krijoni një projekt dhe shkoni te skeda e çelësave të API-së. Krijoni një çelës read dhe një çelës read/write. Ne do t'i ruajmë si variabla mjedisore. Çelësi read është ai që e quajmë public dhe çelësi read/write është secret. Për shembull, mund t'i shtoni në një skedar .env në rrënjën e projektit tuaj.

Gjithashtu do t'ju duhet të shtoni edhe dy variabla të mjedisit: TACOTRANSLATE_DEFAULT_LOCALE dhe TACOTRANSLATE_ORIGIN.

  • TACOTRANSLATE_DEFAULT_LOCALE: Kodi i lokalizimit të parazgjedhur (fallback). Në këtë shembull, do ta vendosim në en për gjuhën angleze.
  • TACOTRANSLATE_ORIGIN: “Dosja” ku do të ruhen tekstet tuaja, si p.sh. URL-ja e faqes suaj. Lexoni më shumë rreth origjinave këtu.
.env
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

Sigurohu që kurrë të mos zbulohet çelësi sekret i API-së read/write në ambientet e prodhimit në anën e klientit.

Konfigurimi i TacoTranslate

Inicializoni TacoTranslate në aplikacionin tuaj React duke rrethuar aplikacionin me ofruesin e kontekstit TacoTranslate:

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

Tani mund të përdorni komponentin Translate kudo në aplikacionin tuaj për të shfaqur tekst të përkthyer! Sigurohuni të shikoni dokumentacionin tonë për më shumë informacion dhe për udhëzime implementimi të përshtatura për konfigurimin tuaj.

import {Translate} from 'tacotranslate/react';

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

Përfitimet e përdorimit të TacoTranslate

  • Kursim kohe: Automatizon procesin e lodhshëm të lokalizimit dhe mbledhjes së teksteve, duke ju kursyer kohë të vlefshme.
  • Kosto-efektive: Redukton nevojën për përkthime manuale, duke ulur kostot tuaja të lokalizimit.
  • Saktësi e përmirësuar: Përkthimet e mundësuara nga AI sigurojnë rezultate të sakta në kontekst dhe me cilësi të lartë.
  • Zgjidhje e shkallëzueshme: Shtoni lehtësisht mbështetje për gjuhë të reja ndërsa aplikacioni dhe baza e klientëve tuaj rriten.

Filloni sot!

Aplikacioni juaj React do të përkthehet automatikisht kur të shtoni ndonjë string në një komponent Translate. Vini re se vetëm ambientet me lejet read/write mbi çelësin e API-së do të mund të krijojnë stringje të reja për t'u përkthyer.

Ne rekomandojmë të keni një mjedis të mbyllur dhe të sigurt për staging ku mund të testoni aplikacionin tuaj të prodhimit, duke shtuar stringje të reja para se të publikoni. Kjo do të parandalojë që dikush të vjedhë çelësin tuaj sekret të API-së dhe, potencialisht, të mbingarkojë projektin tuaj të përkthimit duke shtuar stringje të paautorizuara.

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!

Një produkt nga NattskiftetBërë në Norvegji