Mühelose Lokalisierung für React-Anwendungen

Wie es funktioniert

Installieren Sie das TacoTranslate-Paket über npm:

npm install tacotranslate

Wenn 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.

Innerhalb der TacoTranslate-Anwendungsoberfläche erstellen Sie ein Projekt und navigieren zum Tab für API-Schlüssel. Erstellen Sie einen read Schlüssel und einen read/write Schlüssel. Wir speichern diese als Umgebungsvariablen. Der read Schlüssel wird als public bezeichnet und der read/write Schlüssel als secret. Zum Beispiel können Sie sie in eine .env Datei im Stammverzeichnis Ihres Projekts hinzufügen.

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

• TACOTRANSLATE_DEFAULT_LOCALE: Der standardmäßige Fallback-Locale-Code. 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 Webseite. Hier lesen Sie mehr über Origins.

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

Stellen Sie sicher, dass Sie den geheimen read/write API-Schlüssel niemals in Client-seitigen Produktionsumgebungen preisgeben.

Einrichtung von TacoTranslate

Initialisieren Sie TacoTranslate in Ihrer React-Anwendung, indem Sie Ihre Anwendung im TacoTranslate-Kontext-Provider einschließen:

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 nun die Komponente Translate überall in Ihrer Anwendung verwenden, um übersetzten Text anzuzeigen! Schauen Sie sich unbedingt unsere Dokumentation für weitere Informationen und für Implementierungsanleitungen, die speziell auf Ihre Einrichtung zugeschnitten sind, an.

import {Translate} from 'tacotranslate/react';

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

Vorteile der Nutzung von TacoTranslate

• Zeitersparnis: Automatisiert den mühsamen Prozess der Lokalisierung und des Sammelns von Strings, wodurch Sie wertvolle Zeit sparen.
• Kosteneffizient: Reduziert den Bedarf an manuellen Übersetzungen und senkt so Ihre Lokalisierungskosten.
• Verbesserte Genauigkeit: KI-gestützte Übersetzungen gewährleisten kontextuell genaue und qualitativ hochwertige Ergebnisse.
• Skalierbare Lösung: Ermöglicht es, die Unterstützung für neue Sprachen einfach hinzuzufügen, wenn Ihre Anwendung und Kundenbasis wachsen.

Beginnen Sie noch heute!

Ihre React-Anwendung wird automatisch übersetzt, sobald Sie Zeichenketten zu einer Translate Komponente hinzufügen. Beachten Sie, dass nur Umgebungen mit read/write Berechtigungen für den API-Schlüssel neue zu übersetzende Zeichenketten erstellen können.

Wir empfehlen, eine geschlossene und gesicherte Staging-Umgebung einzurichten, in der Sie Ihre Produktionsanwendung testen und neue Zeichenketten hinzufügen können, bevor Sie live gehen. Dies verhindert, dass jemand Ihren geheimen API-Schlüssel stiehlt und möglicherweise Ihr Übersetzungsprojekt durch unerwünschte Zeichenketten 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!