بهترین راه‌حل برای بین‌المللی‌سازی (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 خود با قرار دادن برنامه‌تان در ارائه‌دهندهٔ زمینهٔ 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 مؤلفه اضافه کنید. توجه داشته باشید که تنها محیط‌هایی که روی کلید API دارای دسترسی‌های read/write باشند قادر خواهند بود رشته‌های جدیدی برای ترجمه ایجاد کنند.

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