Беззусильна локалізація для 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 вашого сайту. Дізнайтеся більше про джерела тут.

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