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 خود با قرار دادن اپلیکیشن‌تان داخل context provider مربوط به 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ساخت نروژ