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

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