بهترین راه‌حل برای بین‌المللی‌سازی (i18n) در اپلیکیشن‌های React

آیا به دنبال گسترش اپلیکیشن React خود به بازارهای جدید هستید؟ TacoTranslate بومی‌سازی اپلیکیشن‌های React را به‌شکل بسیار آسانی ممکن می‌سازد و به شما امکان می‌دهد بدون دردسر به مخاطبان جهانی دست یابید.

چرا TacoTranslate را برای React انتخاب کنید؟

ادغام یکپارچه: TacoTranslate به‌طور اختصاصی برای برنامه‌های React طراحی شده و به‌راحتی در روند کاری فعلی شما ادغام می‌شود.
جمع‌آوری خودکار رشته‌ها: دیگر نیازی به مدیریت دستی فایل‌های 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 خود با قرار دادن برنامه‌تان در ارائه‌دهندهٔ context مربوط به 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

صرفه‌جویی در زمان: فرآیند خسته‌کنندهٔ بومی‌سازی و جمع‌آوری رشته‌ها را خودکار می‌کند و در وقت شما صرفه‌جویی می‌کند.
مقرون‌به‌صرفه: نیاز به ترجمهٔ دستی را کاهش می‌دهد و هزینه‌های بومی‌سازی شما را پایین می‌آورد.
دقت بهبود یافته: ترجمه‌های مبتنی بر هوش مصنوعی نتایجی متناسب با زمینه و با کیفیت بالا را تضمین می‌کنند.
راهکار مقیاس‌پذیر: با رشد اپلیکیشن و پایه‌ی مشتریان‌تان، به‌راحتی پشتیبانی از زبان‌های جدید را اضافه کنید.

همین امروز شروع کنید!

وقتی هر رشته‌ای را به یک کامپوننت Translate اضافه کنید، برنامه React شما به‌طور خودکار ترجمه خواهد شد. توجه داشته باشید که تنها محیط‌هایی که مجوز read/write روی کلید API دارند قادر به ایجاد رشته‌های جدید برای ترجمه خواهند بود.

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