بهترین راه‌حل برای بین‌المللی‌سازی (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، TacoTranslate را در برنامهٔ React خود مقداردهی اولیه کنید:

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