محلیسازی آسان برای برنامههای 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
: "پوشه"ای که رشتههای شما در آن ذخیره خواهند شد، مانند 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
- صرفهجویی در زمان: فرآیند خستهکنندهٔ بومیسازی و جمعآوری متنها را خودکار میسازد و زمان ارزشمند شما را حفظ میکند.
- مقرونبهصرفه: نیاز به ترجمهٔ دستی را کاهش میدهد و هزینههای بومیسازی شما را کم میکند.
- افزایش دقت: ترجمههای مبتنی بر هوش مصنوعی، نتایجی دقیق از نظر زمینه و با کیفیت بالا را تضمین میکنند.
- راهحل مقیاسپذیر: هنگامی که برنامه و پایگاه کاربران شما رشد میکند، بهراحتی میتوانید پشتیبانی از زبانهای جدید را اضافه کنید.
همین امروز شروع کنید!
وقتی هر رشتهای را داخل یک کامپوننت Translate
اضافه کنید، برنامه React شما بهطور خودکار ترجمه خواهد شد. توجه داشته باشید که تنها محیطهایی که دسترسیهای 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!