Лёгкая локализация 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 вашего сайта. Подробнее об origins читайте здесь.

.env

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

Убедитесь, что секретный read/write API-ключ никогда не попадает в клиентскую production-среду.

Настройка 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. Обратите внимание, что только окружения, у которых для ключа API установлены разрешения read/write, смогут создавать новые строки для перевода.

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