Lokalizim pa përpjekje për aplikacionet React

Si funksionon

Instaloni paketën TacoTranslate përmes npm:

npm install tacotranslate

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

Brenda ndërfaqes së aplikacionit TacoTranslate, krijoni një projekt dhe navigoni te skeda e çelësave të API-së. Krijoni një çelës read dhe një çelës read/write. 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.

Do t'ju duhet gjithashtu të shtoni dy variabla të mjedisit: TACOTRANSLATE_DEFAULT_LOCALE dhe TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: Kodi i parazgjedhur i lokalizimit (fallback). Në këtë shembull, do ta vendosim në en për gjuhën angleze.
• TACOTRANSLATE_ORIGIN: “dosja” ku do të ruhen vargjet tuaja, si p.sh. URL-ja e faqes suaj të internetit. Lexoni më shumë rreth origjinave këtu.

TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

Sigurohu që të mos rrjedhësh kurrë çelësin sekret read/write të API-së në mjediset e prodhimit në anën e klientit.

Konfigurimi i TacoTranslate

Inicializoni TacoTranslate në aplikacionin tuaj React duke e rrethuar aplikacionin me provider-in 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 brenda aplikacionit tuaj për të shfaqur tekst të përkthyer! Mos harroni të konsultoni dokumentacionin tonë për më shumë informacion dhe për udhëzime të implementimit specifike 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ë vargjeve, duke ju kursyer kohë të çmuar.
• Kosto-efektive: Redukton nevojën për përkthime manuale, duke ulur kostot e lokalizimit tuaj.
• Saktësi e përmirësuar: Përkthimet e fuqizuara nga AI sigurojnë rezultate të sakta në kontekst dhe me cilësi të lartë.
• Zgjidhje e shkallëzueshme: Shtoni me lehtësi mbështetje për gjuhë të reja teksa aplikacioni dhe baza e klientëve tuaj rriten.

Filloni sot!

Aplikacioni juaj React do të përkthehet automatikisht kur të shtoni cilindo varg në një komponent Translate. Note that only environments with read/write permissions on the API key will be able to create new strings to be translated.

Ne rekomandojmë të keni një mjedis staging të mbyllur dhe të sigurt ku mund të testoni aplikacionin tuaj të prodhimit, duke shtuar vargje të reja para se të dilni në prodhim. Kjo do të parandalojë që këdo këdo t'ju vjedhë çelësin tuaj sekret të API-së, dhe potencialisht të fryjë projektin tuaj të përkthimit duke shtuar vargje të padëshiruara.

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!