وضع المراقبة: إعادة الترجمة التلقائية عند تغيير الملفات

تدعم واجهة سطر أوامر Lingo.dev الآن وضع المراقبة القوي لأمر run، مما يتيح إعادة الترجمة تلقائيًا عندما تتغير ملفات المصدر الخاصة بك.

كيف يعمل

عند تشغيل واجهة سطر الأوامر باستخدام علامة --watch، فإنها تراقب باستمرار ملفات المصدر المكونة (كما هو محدد في حاويات i18n.json الخاصة بك) للتغييرات. عندما تتم إضافة ملف أو تعديله أو حذفه، تقوم واجهة سطر الأوامر تلقائيًا بتشغيل سير عمل الترجمة، وتحديث ملفات اللغة المستهدفة وi18n.lock حسب الحاجة.

هذا مثالي للتطوير السريع، وبيئات المعاينة المباشرة، أو أي سير عمل ترغب فيه أن تبقى الترجمات متزامنة مع محتوى المصدر في الوقت الفعلي.

الاستخدام

npx lingo.dev@latest run --watch
  • ستبدأ واجهة سطر الأوامر في وضع المراقبة، وتعرض سجلات للتغييرات المكتشفة وتقدم الترجمة.
  • بشكل افتراضي، يتم تأجيل التغييرات لمدة 5 ثوانٍ لتجنب التشغيلات المتكررة أثناء التعديلات السريعة.
  • ستستمر العملية في التشغيل حتى توقفها (Ctrl+C).

خيار التأجيل

يمكنك تخصيص تأخير التأجيل (بالميلي ثانية) باستخدام علامة --debounce:

npx lingo.dev@latest run --watch --debounce 10000

يضبط هذا المثال نافذة تأجيل مدتها 10 ثوانٍ بين التغييرات المكتشفة وتشغيل الترجمة التالي.

الميزات

  • إعادة الترجمة التلقائية: تحديث الترجمات فوريًا أثناء تعديل ملفات المصدر.
  • تشغيلات مؤجلة: تمنع طلبات الترجمة المفرطة أثناء التغييرات السريعة للملفات.
  • معالجة الأخطاء: يتعامل وضع المراقبة بسلاسة مع الأخطاء ويستمر في المراقبة بعد الإخفاقات.
  • جميع أنواع الملفات: يعمل مع أي أنواع ملفات مدعومة بواسطة تكوين i18n.json الخاص بك.

متى تستخدم وضع المراقبة

  • أثناء التطوير النشط للميزات متعددة اللغات
  • عند معاينة تغييرات الترجمة مباشرة في تطبيقك
  • للتكامل المستمر مع بيئات التطوير المحلية أو السحابية

نصيحة: تم تصميم وضع المراقبة للتطوير والتكرار السريع. بالنسبة للإنتاج أو CI/CD، استخدم أمر run القياسي بدون --watch لعمليات ترجمة لمرة واحدة.