TacoTranslate
/
ДокументацияЦенообразуване
 
Статия
04.05.2025 г.

Безпроблемна локализация за 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: Кодът на подразбиращия се (fallback) локал. В този пример ще го зададем на 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

Не разкривайте никога тайния API ключ read/write в клиентските продукционни среди.

Настройване на 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Произведено в Норвегия