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.

.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 دارند قادر خواهند بود رشته‌های جدیدی برای ترجمه ایجاد کنند.

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