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