TacoTranslate
/
مستنداتقیمت‌گذاری
 
مقاله
۱۴ اردیبهشت

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

Be sure to check out the complete examples over at our GitHub profile. If you encounter any problems, feel free to reach out, and we’ll be more than happy to help.

TacoTranslate lets you automatically localize your React applications quickly to and from over 75 languages. Translate for free!

یک محصول از Nattskiftetساخت نروژ