TacoTranslate
/
DokumentacjaCennik
 
Artykuł
04 maj

Najlepsze rozwiązanie do internacjonalizacji (i18n) w aplikacjach React

Chcesz rozszerzyć swoją aplikację React na nowe rynki? TacoTranslate sprawia, że lokalizowanie aplikacji React jest niezwykle proste, dzięki czemu możesz dotrzeć do globalnej publiczności bez zbędnych komplikacji.

Dlaczego warto wybrać TacoTranslate dla React?

  • Bezproblemowa integracja: Stworzony specjalnie dla aplikacji React, TacoTranslate bezproblemowo integruje się z Twoim istniejącym przepływem pracy.
  • Automatyczne zbieranie ciągów znaków: Koniec z ręcznym zarządzaniem plikami JSON. TacoTranslate automatycznie zbiera ciągi znaków z Twojego kodu.
  • Tłumaczenia zasilane sztuczną inteligencją: Wykorzystaj moc SI, aby uzyskać tłumaczenia uwzględniające kontekst i pasujące do tonu Twojej aplikacji.
  • Natychmiastowe wsparcie językowe: Dodaj obsługę nowych języków jednym kliknięciem, dzięki czemu Twoja aplikacja stanie się dostępna globalnie.

Jak to działa

Zainstaluj pakiet TacoTranslate za pomocą npm:

npm install tacotranslate

Po zainstalowaniu modułu musisz utworzyć konto TacoTranslate, projekt tłumaczeniowy oraz powiązane klucze API. Utwórz konto tutaj. Jest darmowe i nie wymaga podawania karty kredytowej.

W interfejsie aplikacji TacoTranslate utwórz projekt i przejdź do zakładki kluczy API. Utwórz jeden read klucz i jeden read/write klucz. Zapiszemy je jako zmienne środowiskowe. Klucz read nazywamy public, a klucz read/write to secret. Na przykład możesz dodać je do pliku .env w katalogu głównym projektu.

Będziesz także musiał dodać dwie dodatkowe zmienne środowiskowe: TACOTRANSLATE_DEFAULT_LOCALE i TACOTRANSLATE_ORIGIN.

  • TACOTRANSLATE_DEFAULT_LOCALE: Domyślny kod lokalizacji zapasowej (fallback). W tym przykładzie ustawimy go na en dla języka angielskiego.
  • TACOTRANSLATE_ORIGIN: „folder”, w którym będą przechowywane Twoje ciągi tekstowe, na przykład adres URL Twojej witryny. Dowiedz się więcej o originach tutaj.
.env
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

Upewnij się, że nigdy nie ujawnisz sekretnego klucza API read/write w środowiskach produkcyjnych po stronie klienta.

Konfiguracja TacoTranslate

Zainicjuj TacoTranslate w swojej aplikacji React, opakowując aplikację w dostawcę kontekstu 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>
	);
}

Teraz możesz używać komponentu Translate w dowolnym miejscu swojej aplikacji, aby wyświetlać przetłumaczony tekst! Koniecznie sprawdź naszą dokumentację, aby uzyskać więcej informacji oraz instrukcje wdrożeniowe dostosowane do twojej konfiguracji.

import {Translate} from 'tacotranslate/react';

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

Korzyści z korzystania z TacoTranslate

  • Oszczędność czasu: Automatyzuje żmudny proces lokalizacji i zbierania ciągów tekstowych, oszczędzając cenny czas.
  • Opłacalne: Zmniejsza potrzebę ręcznych tłumaczeń, obniżając koszty lokalizacji.
  • Poprawiona dokładność: Tłumaczenia napędzane przez AI zapewniają kontekstowo trafne i wysokiej jakości rezultaty.
  • Skalowalne rozwiązanie: Łatwo dodawaj obsługę nowych języków w miarę rozwoju aplikacji i bazy klientów.

Zacznij już dziś!

Twoja aplikacja React zostanie przetłumaczona automatycznie, gdy dodasz jakiekolwiek teksty do komponentu Translate. Zwróć uwagę, że tylko środowiska mające uprawnienia read/write dla klucza API będą mogły tworzyć nowe ciągi przeznaczone do tłumaczenia.

Zalecamy posiadanie zamkniętego i zabezpieczonego środowiska stagingowego, w którym możesz testować aplikację produkcyjną i dodawać nowe teksty przed uruchomieniem na żywo. Zapobiegnie to kradzieży twojego sekretnego klucza API oraz ewentualnemu zapełnieniu projektu tłumaczeń przez dodawanie niechcianych ciągów.

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!

Produkt firmy NattskiftetWyprodukowano w Norwegii