La meilleure solution pour l'internationalisation (i18n) dans les applications React

Comment ça fonctionne

Installez le paquet TacoTranslate via npm :

npm install tacotranslate

Lorsque vous avez installé le module, vous devez créer un compte TacoTranslate, un projet de traduction et les clés API associées. Créez un compte ici. C’est gratuit, et cela ne nécessite pas d’ajouter une carte de crédit.

Dans l’interface de l’application TacoTranslate, créez un projet et accédez à son onglet des clés API. Créez une clé read et une clé read/write. Nous les enregistrerons en tant que variables d’environnement. La clé read est ce que nous appelons public et la clé read/write est secret. Par exemple, vous pourriez les ajouter dans un fichier .env à la racine de votre projet.

Vous devrez également ajouter deux autres variables d’environnement : TACOTRANSLATE_DEFAULT_LOCALE et TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE : Le code de la locale par défaut de secours. Dans cet exemple, nous le définirons sur en pour l’anglais.
• TACOTRANSLATE_ORIGIN : Le « dossier » où vos chaînes seront stockées, comme l’URL de votre site Web. En savoir plus sur les origines ici.

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

Assurez-vous de ne jamais divulguer la clé API secrète read/write dans les environnements de production côté client.

Configuration de TacoTranslate

Initialisez TacoTranslate dans votre application React en enveloppant votre application dans le fournisseur de contexte 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>
	);
}

Vous pouvez maintenant utiliser le composant Translate n’importe où dans votre application pour afficher du texte traduit ! Assurez-vous de consulter notre documentation pour plus d’informations et des guides d’implémentation spécifiques à votre configuration.

import {Translate} from 'tacotranslate/react';

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

Avantages d’utiliser TacoTranslate

• Gain de temps : Automatise le processus fastidieux de localisation et de collecte des chaînes, vous faisant ainsi gagner un temps précieux.
• Rentable : Réduit le besoin de traductions manuelles, diminuant vos coûts de localisation.
• Précision améliorée : Les traductions alimentées par l’IA garantissent des résultats précis et de haute qualité, adaptés au contexte.
• Solution évolutive : Ajoutez facilement la prise en charge de nouvelles langues au fur et à mesure que votre application et votre base de clients grandissent.

Commencez dès aujourd'hui !

Votre application React sera traduite automatiquement lorsque vous ajoutez des chaînes à un composant Translate. Notez que seuls les environnements disposant des permissions read/write sur la clé API pourront créer de nouvelles chaînes à traduire.

Nous recommandons d’avoir un environnement de préproduction fermé et sécurisé où vous pouvez tester votre application en production, en ajoutant de nouvelles chaînes avant la mise en ligne. Cela empêchera toute personne de voler votre clé API secrète et potentiellement d’alourdir votre projet de traduction en ajoutant des chaînes indésirables.

Assurez-vous de consulter les exemples complets sur notre profil GitHub. Si vous rencontrez des problèmes, n’hésitez pas à nous contacter, nous serons ravis de vous aider.

TacoTranslate vous permet de localiser automatiquement vos applications React rapidement vers et depuis n’importe quelle langue. Traduisez gratuitement !