بهترین راه‌حل برای بین‌المللی‌سازی (i18n) در برنامه‌های 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: "پوشه‌ای" که رشته‌های شما در آن ذخیره خواهند شد، مانند آدرس وب‌سایت شما. برای اطلاعات بیشتر در مورد مبداها اینجا را بخوانید.

.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 دارند قادر خواهند بود رشته‌های جدیدی برای ترجمه ایجاد کنند.

ما توصیه می‌کنیم یک محیط آزمایشی بسته و امن داشته باشید که در آن بتوانید برنامهٔ تولیدی خود را آزمایش کنید و قبل از انتشار رشته‌های جدید را اضافه نمایید. این کار از سرقت کلید API مخفی شما توسط دیگران جلوگیری می‌کند و همچنین از احتمال متورم شدن پروژهٔ ترجمه‌تان به‌خاطر اضافه شدن رشته‌های ناخواسته یا مخرب جلوگیری می‌نماید.