Die beste oplossing vir internasionalisering (i18n) in React-toepassings

Hoe dit werk

Installeer die TacoTranslate-pakket via npm:

npm install tacotranslate

Sodra jy die module geïnstalleer het, sal jy 'n TacoTranslate-rekening, 'n vertaalprojek en die gekoppelde API-sleutels moet skep. Maak hier 'n rekening aan. Dit is gratis, en jy hoef nie 'n kredietkaart by te voeg nie.

In die TacoTranslate-toepassing se UI, skep 'n projek en navigeer na die oortjie vir API-sleutels. Skep een read sleutel en een read/write sleutel. Ons sal dit as omgewing-variabeles stoor. Die read sleutel is wat ons public noem en die read/write sleutel is secret. Byvoorbeeld, jy kan hulle by 'n .env lêer in die wortel van jou projek voeg.

Jy sal ook nog twee omgewingsveranderlikes moet byvoeg: TACOTRANSLATE_DEFAULT_LOCALE en TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: Die standaard terugval-lokaalkode. In hierdie voorbeeld stel ons dit op en vir Engels.
• TACOTRANSLATE_ORIGIN: Die “map” waar jou stringe gestoor sal word, soos die URL van jou webwerf. Lees hier meer oor oorspronge.

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

Maak seker dat jy nooit die geheime read/write API-sleutel na kliëntkant-produksie-omgewings lek nie.

TacoTranslate opstel

Initialiseer TacoTranslate in jou React-toepassing deur jou toepassing in die TacoTranslate-konteksverskaffer te plaas:

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

Jy kan nou die Translate komponent enige plek binne jou toepassing gebruik om vertaalde teks te vertoon! Maak seker om ons dokumentasie na te gaan vir meer inligting, en vir implementeringsgidse wat spesifiek is vir jou opstelling.

import {Translate} from 'tacotranslate/react';

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

Voordele van die gebruik van TacoTranslate

• Tydsbesparend: Outomatiseer die vervelige proses van lokalisering en die versameling van stringe, en bespaar jou kosbare tyd.
• Koste-effektief: Verminder die behoefte aan handvertalings, en verlaag jou lokalisasiekoste.
• Verbeterde akkuraatheid: KI-gedrewe vertalings verseker kontekstueel akkurate en hoë-kwaliteit resultate.
• Skaalbare oplossing: Voeg maklik ondersteuning vir nuwe tale by namate jou toepassing en kliëntebasis groei.

Begin vandag nog!

Jou React-toepassing sal outomaties vertaal word wanneer jy enige stringe by 'n Translate komponent voeg. Let wel dat slegs omgewings met read/write regte op die API-sleutel nuwe stringe sal kan skep wat vertaal kan word.

Ons beveel aan dat jy 'n geslote en beveiligde staging-omgewing het waar jy jou produksietoepassing kan toets en nuwe stringe kan byvoeg voordat jy lewendig gaan. Dit sal verhoed dat iemand iemand jou geheime API-sleutel steel, en moontlik jou vertaalprojek opblaas deur ongewenste stringe by te voeg.

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!