التثبيت

تعمل الحزمة الأساسية في أي مشروع TypeScript، بغض النظر عن الإطار أو بيئة التشغيل. إذا كنت تستخدم إطار عمل مثل Next.js أو React أو Astro، يمكنك إضافة المحول المطابق فوق الحزمة الأساسية.

الحزمة الأساسية

npm install @better-translate/core

هذا كل ما تحتاجه في معظم الحالات. يعمل في Next.js وAstro وReact وBun وNode.js والنصوص البرمجية وواجهات API أو أي بيئة TypeScript.

المحولات

المحولات هي امتدادات للحزمة الأساسية تضيف مساعدات خاصة بالإطار: التوجيه المدرك للإعدادات المحلية، وسياق React والخطافات، والمساعدات لكل طلب، إلخ. لا تحل محل الحزمة الأساسية، بل تمدها.

يمكنك التحقق من المحولات المتاحة هنا:

واجهة سطر الأوامر

واجهة سطر الأوامر هي أداة تطوير اختيارية تزيل العمل اليدوي في إدارة ملفات الإعدادات المحلية.

تقوم بأمرين:

• استخراج — تفحص الكود بحثًا عن النصوص المعلمة بـ { bt: true }، وتضيفها إلى ملف الإعدادات المحلية المصدر بمفاتيح مُنشأة تلقائيًا، وإعادة كتابة الاستدعاءات في مكانها
• توليد — تقرأ ملف الإعدادات المحلية المصدر وتستخدم نموذج ذكاء اصطناعي لإنتاج نسخ مترجمة لكل إعداد محلي آخر

npm install -D @better-translate/cli

بالنسبة لإعدادات gateway، يكفي تثبيت @better-translate/cli. إذا كان better-translate.config.ts لديك يستورد مزود نموذج مباشر مثل Ollama، ثبّت أيضًا حزمة المزود المناسبة، مثل npm install -D ollama-ai-provider-v2.

قبل تشغيل npx bt extract أو npx bt generate، أنشئ ملف better-translate.config.ts. بعد ضبط الإعدادات، تعمل واجهة سطر الأوامر مع أي نموذج من مزودي AI SDK، بما في ذلك نماذج Ollama المحلية.

المتطلبات

• Node.js 18+ أو Bun 1.0+
• TypeScript 5.x موصى به

الخطوة التالية