Die beste Lösung für Internationalisierung (i18n) in React-Apps

Wie es funktioniert

Installieren Sie das TacoTranslate-Paket über npm:

npm install tacotranslate

Sobald Sie das Modul installiert haben, müssen Sie ein TacoTranslate-Konto, ein Übersetzungsprojekt und die zugehörigen API‑Schlüssel erstellen. Erstellen Sie hier ein Konto. Es ist kostenlos und erfordert keine Angabe einer Kreditkarte.

Öffne in der TacoTranslate-Anwendungsoberfläche ein Projekt und navigiere zum Reiter „API-Schlüssel“. Erstelle einen read Schlüssel und einen read/write Schlüssel. Wir speichern diese als Umgebungsvariablen. Der read Schlüssel ist das, was wir public nennen, und der read/write Schlüssel ist secret. Zum Beispiel könntest du sie in einer .env Datei im Stammverzeichnis deines Projekts ablegen.

Sie müssen außerdem zwei weitere Umgebungsvariablen hinzufügen: TACOTRANSLATE_DEFAULT_LOCALE und TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: Der standardmäßige Fallback-Sprachcode. In diesem Beispiel setzen wir ihn auf en für Englisch.
• TACOTRANSLATE_ORIGIN: Der „Ordner“, in dem Ihre Strings gespeichert werden, zum Beispiel die URL Ihrer Website. Weitere Informationen zu Origins finden Sie hier.

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

Stelle sicher, dass du den geheimen read/write API-Schlüssel niemals in clientseitigen Produktionsumgebungen preisgibst.

TacoTranslate einrichten

Initialisieren Sie TacoTranslate in Ihrer React-Anwendung, indem Sie Ihre Anwendung im TacoTranslate-Kontext-Provider einbetten:

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

Sie können jetzt die Translate Komponente überall in Ihrer Anwendung verwenden, um übersetzten Text anzuzeigen! Sehen Sie sich unbedingt unsere Dokumentation für weitere Informationen und Implementierungsanleitungen an, die speziell auf Ihre Einrichtung zugeschnitten sind.

import {Translate} from 'tacotranslate/react';

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

Vorteile von TacoTranslate

• Zeitersparnis: Automatisiert den mühsamen Prozess der Lokalisierung und das Sammeln von Strings und spart Ihnen wertvolle Zeit.
• Kosteneffizient: Verringert den Bedarf an manuellen Übersetzungen und senkt Ihre Lokalisierungskosten.
• Verbesserte Genauigkeit: KI-gestützte Übersetzungen sorgen für kontextgenaue und hochwertige Ergebnisse.
• Skalierbare Lösung: Fügen Sie einfach Unterstützung für neue Sprachen hinzu, wenn Ihre Anwendung und Ihre Kundenbasis wachsen.

Jetzt loslegen!

Ihre React-Anwendung wird automatisch übersetzt, wenn Sie beliebige Strings in eine Translate Komponente einfügen. Beachten Sie, dass nur Umgebungen, deren API-Schlüssel read/write Berechtigungen hat, neue zu übersetzende Strings erstellen können.

Wir empfehlen, eine geschlossene und gesicherte Staging-Umgebung einzurichten, in der Sie Ihre Produktionsanwendung testen und neue Strings hinzufügen können, bevor Sie live gehen. Dies verhindert, dass niemand niemand Ihren geheimen API-Schlüssel stiehlt und möglicherweise Ihr Übersetzungsprojekt durch das Hinzufügen bösartiger Strings aufbläht.

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!