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

بومی‌سازی آسان برای برنامه‌های React

آیا می‌خواهید اپلیکیشن React خود را به بازارهای جدید گسترش دهید؟ TacoTranslate بومی‌سازی اپلیکیشن‌های React را بسیار آسان می‌کند و به شما امکان می‌دهد بدون هیچ‌گونه دردسر به مخاطبان جهانی دسترسی پیدا کنید.

چرا TacoTranslate را برای React انتخاب کنیم؟

  • Seamless Integration: طراحی شده به‌طور خاص برای برنامه‌های React، TacoTranslate به‌راحتی در گردش کار موجود شما ادغام می‌شود.
  • Automatic String Collection: دیگر نیازی به مدیریت دستی فایل‌های JSON نیست. TacoTranslate به‌طور خودکار رشته‌ها را از کدپایهٔ شما جمع‌آوری می‌کند.
  • AI-Powered Translations: از قدرت هوش مصنوعی برای ارائه ترجمه‌هایی بهره ببرید که از نظر زمینه‌ای دقیق و متناسب با لحن برنامه شما باشند.
  • Instant Language Support: با تنها یک کلیک پشتیبانی از زبان‌های جدید را اضافه کنید و برنامه‌تان را در سطح جهانی قابل دسترس کنید.

چگونه کار می‌کند

بسته 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ساخت نروژ