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

ما توصیه می‌کنیم یک محیط پیش‌نمایش (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ساخت نروژ