Bezproblemowa lokalizacja aplikacji React

Jak to działa

Zainstaluj pakiet TacoTranslate za pomocą npm:

npm install tacotranslate

Gdy moduł jest już zainstalowany, musisz utworzyć konto TacoTranslate, projekt tłumaczeniowy oraz powiązane klucze API. Utwórz konto tutaj. To bezpłatne i nie wymaga podawania danych karty kredytowej.

W interfejsie aplikacji TacoTranslate stwórz projekt i przejdź do zakładki z kluczami API. Utwórz jeden klucz read oraz jeden klucz read/write. 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 swojego projektu.

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

• TACOTRANSLATE_DEFAULT_LOCALE: Domyślny kod lokalizacji zapasowej. W tym przykładzie ustawimy go na en dla angielskiego.
• TACOTRANSLATE_ORIGIN: „Folder”, w którym będą przechowywane Twoje ciągi tekstowe, np. adres URL Twojej strony internetowej. Przeczytaj więcej o originach tutaj.

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 udostępniasz 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 zapoznaj się z naszą dokumentacją, aby uzyskać więcej informacji oraz przewodniki 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 tekstów, oszczędzając Twój cenny czas.
• Opłacalne: Redukuje potrzebę ręcznych tłumaczeń, obniżając koszty lokalizacji.
• Poprawiona dokładność: Tłumaczenia wspierane przez AI zapewniają kontekstowo dokładne i wysokiej jakości wyniki.
• Skalowalne rozwiązanie: Łatwo dodawaj wsparcie dla 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 ciągi znaków do komponentu Translate. Pamiętaj, że tylko środowiska z uprawnieniami read/write do klucza API będą mogły tworzyć nowe ciągi do przetłumaczenia.

Zalecamy posiadanie zamkniętego i zabezpieczonego środowiska stagingowego, gdzie możesz testować swoją aplikację produkcyjną, dodając nowe ciągi przed uruchomieniem na żywo. Zapobiegnie to kradzieży Twojego tajnego klucza API oraz potencjalnemu rozdmuchaniu projektu tłumaczeniowego przez dodawanie nieautoryzowanych 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!