وضع المراقبة: إعادة الترجمة التلقائية عند تغيير الملفات
يدعم Lingo.dev CLI الآن وضع مراقبة قوياً لأمر run، مما يتيح إعادة الترجمة التلقائية كلما تغيرت ملفات المصدر الخاصة بك.
كيف يعمل
عند تشغيل CLI مع علامة --watch، فإنه يراقب باستمرار ملفات المصدر المكونة لديك (كما هو محدد في حاويات i18n.json الخاصة بك) بحثاً عن التغييرات. عند إضافة ملف أو تعديله أو حذفه، يقوم CLI تلقائياً بتشغيل سير عمل الترجمة، وتحديث ملفات اللغة المستهدفة و i18n.lock حسب الحاجة.
هذا مثالي للتطوير السريع أو بيئات المعاينة المباشرة أو أي سير عمل تريد فيه أن تظل الترجمات متزامنة مع محتوى المصدر الخاص بك في الوقت الفعلي.
الاستخدام
npx lingo.dev@latest run --watch
- سيبدأ CLI في وضع المراقبة، مع عرض سجلات للتغييرات المكتشفة وتقدم الترجمة.
- بشكل افتراضي، يتم تأخير التغييرات لمدة 5 ثوانٍ لتجنب التشغيلات الزائدة أثناء التعديلات السريعة.
- ستستمر العملية في العمل حتى توقفها (Ctrl+C).
خيار التأخير
يمكنك تخصيص تأخير الانتظار (بالميلي ثانية) باستخدام علامة --debounce:
npx lingo.dev@latest run --watch --debounce 10000
يحدد هذا المثال نافذة تأخير مدتها 10 ثوانٍ بين التغييرات المكتشفة وتشغيل الترجمة التالي.
الميزات
- إعادة الترجمة التلقائية: تحديث الترجمات فوراً أثناء تحرير ملفات المصدر.
- تشغيلات متأخرة: يمنع طلبات الترجمة المفرطة أثناء تغييرات الملفات السريعة.
- معالجة الأخطاء: يتعامل وضع المراقبة مع الأخطاء بسلاسة ويستمر في المراقبة بعد الفشل.
- جميع أنواع الملفات: يعمل مع أي أنواع ملفات مدعومة بواسطة تكوين
i18n.jsonالخاص بك.
متى تستخدم وضع المراقبة
- أثناء التطوير النشط للميزات متعددة اللغات
- عند معاينة تغييرات الترجمة مباشرة في تطبيقك
- للتكامل المستمر مع بيئات التطوير المحلية أو السحابية
نصيحة: تم تصميم وضع المراقبة للتطوير والتكرار السريع. للإنتاج أو CI/CD، استخدم الأمر القياسي run بدون --watch لعمليات الترجمة لمرة واحدة.