Лучшее решение для интернационализации (i18n) в приложениях на React

Хотите расширить своё React-приложение на новые рынки? TacoTranslate делает локализацию React-приложений невероятно простой, позволяя вам охватить глобальную аудиторию без лишних хлопот.

Почему стоит выбрать TacoTranslate для React?

Бесшовная интеграция: Разработан специально для приложений на React; TacoTranslate легко интегрируется в ваш существующий рабочий процесс.
Автоматический сбор строк: Больше не нужно вручную управлять JSON-файлами. TacoTranslate автоматически собирает строки из вашего кода.
Переводы на основе ИИ: Используйте возможности ИИ для получения контекстно точных переводов, соответствующих тону вашего приложения.
Мгновенная поддержка языков: Добавьте поддержку новых языков всего одним кликом, сделав ваше приложение доступным по всему миру.

Как это работает

Установите пакет TacoTranslate через npm:

npm install tacotranslate

После установки модуля вам потребуется создать аккаунт TacoTranslate, проект перевода и соответствующие API-ключи. Создайте аккаунт здесь. Это бесплатно, и не требует указания данных кредитной карты.

В интерфейсе приложения TacoTranslate создайте проект и перейдите на вкладку API-ключей. Создайте один read ключ и один read/write ключ. Мы сохраним их как переменные окружения. Ключ read — это то, что мы называем public, а ключ read/write — secret. Например, вы можете добавить их в файл .env в корне вашего проекта.

Вам также нужно добавить ещё две переменные окружения: TACOTRANSLATE_DEFAULT_LOCALE и TACOTRANSLATE_ORIGIN.

TACOTRANSLATE_DEFAULT_LOCALE: Код локали по умолчанию, используемой в качестве резервной. В этом примере мы установим его в en для английского.
TACOTRANSLATE_ORIGIN: «Папка», в которой будут храниться ваши строки, например URL вашего сайта. Подробнее об origin'ах здесь.

.env

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

Ни в коем случае не раскрывайте секретный read/write API-ключ в продакшен‑средах на стороне клиента.

Настройка TacoTranslate

Инициализируйте TacoTranslate в вашем React-приложении, обернув приложение в провайдер контекста 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>
	);
}

Теперь вы можете использовать компонент Translate в любом месте вашего приложения, чтобы отображать переведённый текст! Обязательно ознакомьтесь с нашей документацией для получения дополнительной информации и руководств по внедрению, специфичных для вашей настройки.

import {Translate} from 'tacotranslate/react';

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

Преимущества использования TacoTranslate

Экономия времени: Автоматизирует утомительный процесс локализации и сбора строк, экономя ваше драгоценное время.
Экономично: Снижает потребность в ручных переводах, уменьшая ваши затраты на локализацию.
Повышенная точность: Переводы на базе ИИ обеспечивают контекстно корректные и высококачественные результаты.
Масштабируемое решение: Легко добавляйте поддержку новых языков по мере роста вашего приложения и клиентской базы.

Начните уже сегодня!

Ваше React-приложение будет автоматически переведено, когда вы добавите любые строки в компонент Translate. Обратите внимание, что только среды с правами read/write для ключа API смогут создавать новые строки для перевода.

Мы рекомендуем иметь закрытую и защищённую среду подготовки (staging), где вы сможете тестировать ваше производственное приложение, добавляя новые строки до выхода в продакшен. Это предотвратит, что кто-либо кто-либо украдёт ваш секретный ключ API и потенциально раздует ваш проект переводов, добавляя нежелательные строки.