TacoTranslate
/
ДокументацияЦены
 
Статья
04 мая 2025 г.

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

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

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

  • Seamless Integration: Разработан специально для приложений на React, TacoTranslate легко интегрируется в ваш существующий рабочий процесс.
  • Automatic String Collection: Больше не нужно вручную управлять JSON-файлами. TacoTranslate автоматически собирает строки из вашего кода.
  • AI-Powered Translations: Используйте мощь ИИ, чтобы получать контекстно точные переводы, соответствующие тону вашего приложения.
  • Instant Language Support: Добавляйте поддержку новых языков одним кликом, делая ваше приложение доступным по всему миру.

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

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

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

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!

Продукт от NattskiftetСделано в Норвегии