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

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!