TacoTranslate
/
مستنداتقیمت‌گذاری
 
مقاله
۱۴ ثور ۱۴۰۴

محلی‌سازی آسان برای برنامه‌های 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 context provider:

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

  • صرفه‌جویی در وقت: فرآیند خسته‌کنندهٔ بومی‌سازی و جمع‌آوری رشته‌ها را خودکار نموده و وقت ارزشمند شما را حفظ می‌کند.
  • مقرون‌به‌صرفه: نیاز به ترجمه‌های دستی را کاهش می‌دهد و هزینه‌های بومی‌سازی شما را پایین می‌آورد.
  • دقت بهبود یافته: ترجمه‌های مبتنی بر هوش مصنوعی دقت زمینه‌ای و نتایج با کیفیت بالا را تضمین می‌کنند.
  • راه‌حل مقیاس‌پذیر: با رشد برنامه و پایگاه مشتریان‌تان، به‌راحتی پشتیبانی از زبان‌های جدید را اضافه کنید.

همین امروز شروع کنید!

وقتی هر رشته‌ای را به یک کامپوننت Translate اضافه کنید، برنامه React شما به‌طور خودکار ترجمه خواهد شد. توجه داشته باشید که تنها محیط‌هایی که روی کلید API مجوز read/write را دارند قادر به ایجاد رشته‌های جدید برای ترجمه خواهند بود.

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