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

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

Skep binne die TacoTranslate-app se UI ’n projek en navigeer na die oortjie vir API-sleutels. Skep een read sleutel en een read/write sleutel. Ons sal dit stoor as omgewingsveranderlikes. Die read sleutel is wat ons public noem en die read/write sleutel is secret. Byvoorbeeld, jy kan dit 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 meer oor oorspronge hier.

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 aan kliëntkant-produksie-omgewings uitlek nie.

TacoTranslate instel

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

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 in jou toepassing gebruik om vertaalde teks te vertoon! Kyk gerus na ons dokumentasie vir meer inligting en vir implementasiegidse 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: Automatiseer die vervelige proses van lokalisering en die insameling van tekenreekse, wat jou waardevolle tyd bespaar.
• Koste-effektief: Verminder die behoefte aan handvertalings en verlaag jou lokalisasiekoste.
• Verbeterde akkuraatheid: KI-gedrewe vertalings lewer kontekstueel akkurate en hoë kwaliteit resultate.
• Skaalbare oplossing: Voeg maklik ondersteuning vir nuwe tale by namate jou toepassing en kliëntebasis groei.

Begin vandag!

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

Ons beveel aan om 'n geslote en beveiligde staging-omgewing te hê waar jy jou produksietoepassing kan toets en nuwe stringe kan byvoeg voordat dit regstreeks gaan. Dit sal voorkom dat enigiemand enigiemand jou geheime API-sleutel steel, en moontlik jou vertaalprojek laat opblaas deur die toevoeging van ongewenste stringe.

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!