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: «پوشه‌ای» که رشته‌های شما در آن ذخیره خواهند شد، مانند آدرس وب‌سایت شما. برای اطلاعات بیشتر دربارهٔ مبداها اینجا را بخوانید.
.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 را دارند قادر خواهند بود رشته‌های جدیدی برای ترجمه ایجاد کنند.

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