TacoTranslate
/
ДокументаціяЦіноутворення
 
Стаття
04 трав.

Легка локалізація для 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/writesecret. Наприклад, ви можете додати їх у файл .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 ключ у клієнтських виробничих середовищах.

Налаштування 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-ключа та потенційному роздуванню проєкту перекладу через додавання невідповідних рядків.

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Зроблено в Норвегії