بهترین راهحل برای بینالمللیسازی (i18n) در برنامههای 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
: «پوشه»ای که رشتههای شما در آن ذخیره میشوند، مانند آدرس وبسایت شما. در اینجا بیشتر درباره origins بخوانید.
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com
حتماً مراقب باشید که کلید API مخفی read/write
را هرگز در محیطهای تولید سمت کاربر فاش نکنید.
راهاندازی TacoTranslate
تاکوترنسلیت را در برنامه React خود با قرار دادن برنامهتان درون ارائهدهنده زمینه تاکوترنسلیت مقداردهی اولیه کنید:
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!