التعريب السلس لتطبيقات 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 السري الخاص بك، ومن المحتمل أن يمنع تضخم مشروع الترجمة الخاص بك بإضافة سلاسل غير مرغوب فيها.

تأكد من مراجعة الأمثلة الكاملة على ملفنا في GitHub. إذا واجهت أي مشاكل، لا تتردد في الاتصال بنا، وسنكون سعداء جدًا بالمساعدة.

تتيح لك TacoTranslate القيام بالتوطين التلقائي لتطبيقات React الخاصة بك بسرعة من وإلى أي لغة. ترجم مجانًا!