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

.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 providerِ 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 محرمانهٔ شما توسط دیگران جلوگیری می‌کند و از احتمال متورم شدن پروژهٔ ترجمه‌تان با اضافه شدن رشته‌های ناخواسته جلوگیری می‌کند.