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

نحوه کارکرد

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

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

مطمئن شوید که نمونه‌های کامل را در پروفایل گیت‌هاب ما بررسی کنید. اگر با مشکلی مواجه شدید، به‌راحتی می‌توانید با ما تماس بگیرید، و ما با کمال میل به شما کمک خواهیم کرد.

TacoTranslate به شما اجازه می‌دهد برنامه‌های React خود را به‌صورت خودکار و سریع به هر زبانی و از هر زبان دیگری بومی‌سازی کنید. رایگان ترجمه کنید!