Bezproblémová lokalizace pro React aplikace

Jak to funguje

Nainstalujte balíček TacoTranslate pomocí npm:

npm install tacotranslate

Když máte modul nainstalovaný, budete si muset vytvořit účet TacoTranslate, překladatelský projekt a přidružené API klíče. Vytvořte si účet zde. Je to zdarma a nevyžaduje to přidání platební karty.

V uživatelském rozhraní aplikace TacoTranslate vytvořte projekt a přejděte na záložku s API klíči. Vytvořte jeden read klíč a jeden read/write klíč. Uložíme je jako proměnné prostředí. read klíč nazýváme public a read/write klíč je secret. Například je můžete přidat do souboru .env v kořenovém adresáři vašeho projektu.

Také budete muset přidat další dvě proměnné prostředí: TACOTRANSLATE_DEFAULT_LOCALE a TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: Výchozí kód záložního jazyka. V tomto příkladu ho nastavíme na en pro angličtinu.
• TACOTRANSLATE_ORIGIN: „Složka“, ve které budou vaše řetězce uloženy, například URL vašeho webu. Přečtěte si zde více o původech.

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

Ujistěte se, že nikdy neprozradíte tajný read/write API klíč do produkčních prostředí na straně klienta.

Nastavení TacoTranslate

Inicializujte TacoTranslate ve vaší React aplikaci tak, že obalíte vaši aplikaci do poskytovatele kontextu 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>
	);
}

Nyní můžete použít komponentu Translate kdekoli ve vaší aplikaci pro zobrazení přeloženého textu! Nezapomeňte si pro více informací a návody na implementaci specificky pro vaše nastavení prohlédnout naši dokumentaci.

import {Translate} from 'tacotranslate/react';

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

Výhody používání TacoTranslate

• Úspora času: Automatizuje nudný proces lokalizace a sběru řetězců, čímž vám šetří cenný čas.
• Úsporné řešení: Snižuje potřebu manuálních překladů, čímž snižuje vaše náklady na lokalizaci.
• Zlepšená přesnost: Překlady poháněné AI zajišťují kontextově přesné a vysoce kvalitní výsledky.
• Škálovatelné řešení: Snadno přidávejte podporu nových jazyků, jak vaše aplikace a zákaznická základna rostou.

Začněte ještě dnes!

Vaše React aplikace bude automaticky přeložena, když přidáte jakékoli řetězce do komponenty Translate. Všimněte si, že pouze prostředí s oprávněními read/write k API klíči budou schopna vytvářet nové řetězce k překladu.

Doporučujeme mít uzavřené a zabezpečené stagingové prostředí, kde můžete otestovat svou produkční aplikaci a přidávat nové řetězce před jejím spuštěním. Tím zabráníte tomu, aby někdo ukradl váš tajný API klíč, a zároveň zabráníte zbytečnému nafouknutí vašeho překladatelského projektu přidáváním nepovolených řetězců.

Určitě si prohlédněte kompletní příklady na našem GitHub profilu. Pokud narazíte na jakékoli problémy, neváhejte nás kontaktovat, rádi vám pomůžeme.

TacoTranslate vám umožní snadno a rychle lokalizovat vaše React aplikace do libovolného jazyka a zpět. Přeložit zdarma!