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, moet jy 'n TacoTranslate-rekening, 'n vertaalprojek en die verwante API-sleutels skep. Skep hier 'n rekening. Dit is gratis, en vereis nie dat jy 'n kredietkaart byvoeg nie.

Binne die TacoTranslate-toepassingsgebruikerskoppelvlak, skep ’n projek en navigeer na die API-sleutels-oortjie daarvan. Skep een read sleutel en een read/write sleutel. Ons sal hulle as omgewingsveranderlikes 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 “gids” 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 die geheime read/write API-sleutel nooit in kliëntkant-produksie-omgewings lek nie.

TacoTranslate instel

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 dat jy ons dokumentasie raadpleeg 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

• Tydsbesparing: Outomatiseer die vervelige proses van lokalisering en die insameling van stringe, en bespaar jou waardevolle tyd.
• Kostedoeltreffend: Verminder die behoefte aan handmatige vertalings, wat jou lokalisasiekoste verlaag.
• Verbeterde akkuraatheid: KI-aangedrewe vertalings verseker kontekstueel akkurate resultate van hoë gehalte.
• 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 daarop dat slegs omgewings met read/write toestemming op die API-sleutel nuwe stringe kan skep wat vertaal moet word.

Ons beveel aan om 'n geslote en veilige staging-omgewing te hê waar jy jou produksietoepassing kan toets en nuwe stringe kan byvoeg voordat dit regstreeks beskikbaar gestel word. Dit sal voorkom dat iemand iemand jou geheime API-sleutel steel, en moontlik jou vertaalprojek opblaas deur skadelike 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!