Skip to content

Latest commit

 

History

History
244 lines (191 loc) · 8.88 KB

GUI_USER_GUIDE.md

File metadata and controls

244 lines (191 loc) · 8.88 KB

دليل استخدام الواجهة الرسومية - مترجم الترجمات المتقدم

نظرة عامة

مترجم الترجمات المتقدم يوفر واجهة رسومية سهلة الاستخدام لترجمة ملفات الترجمات بين اللغات المختلفة. يدعم البرنامج تنسيقات SRT و ASS و VTT مع إمكانيات متقدمة مثل الكاش الذكي وكشف اللغة التلقائي.

🚀 بدء التشغيل

التشغيل السريع

python gui_translator.py

متطلبات النظام

  • Python 3.7 أو أحدث
  • Windows/Mac/Linux
  • اتصال بالإنترنت للترجمة

📱 واجهة البرنامج

التبويبات الرئيسية

1. 📄 ملف واحد (Single File)

الغرض: ترجمة ملف ترجمة واحد

المكونات:

  • منطقة اختيار الملفات:

    • ملف الإدخال: اختر الملف المراد ترجمته
    • ملف الإخراج: حدد مكان حفظ الترجمة
    • أزرار: Browse, Clear, Auto
  • كشف اللغة:

    • ☑️ كشف تلقائي للغة المصدر
    • اختيار اللغة المصدر يدوياً
    • زر "Detect Now" للكشف الفوري
    • اختيار اللغة المستهدفة
  • خيارات التنسيق:

    • كشف تنسيق الإدخال تلقائياً
    • اختيار تنسيق الإخراج (.srt, .ass, .vtt)
  • خيارات الترجمة:

    • محرك الترجمة (Google/Microsoft)
    • ☑️ إنشاء نسخة احتياطية
    • ☑️ استخدام الكاش
  • شريط التقدم:

    • عرض نسبة الإنجاز
    • حالة العملية الحالية

الأزرار:

  • 🚀 Start Translation: بدء الترجمة
  • ⏹ Stop: إيقاف الترجمة
  • 👁 Preview: معاينة الملف
  • 📁 Open Output Folder: فتح مجلد الإخراج

2. 📁 المعالجة المجمعة (Batch Process)

الغرض: ترجمة عدة ملفات دفعة واحدة

المكونات:

  • قائمة الملفات:

    • عرض الملفات في جدول
    • أعمدة: الاسم، التنسيق، اللغة المصدر، اللغة المستهدفة، الحالة
  • أزرار التحكم:

    • ➕ Add Files: إضافة ملفات
    • 📁 Add Folder: إضافة مجلد
    • 🗑 Remove Selected: حذف المحدد
    • 🗑 Clear All: مسح الكل
    • 🚀 Start Batch Translation: بدء الترجمة المجمعة
  • شريط التقدم المجمع:

    • عرض تقدم المعالجة المجمعة
    • عدد الملفات المكتملة

3. ⚙️ الإعدادات (Settings)

الغرض: تخصيص إعدادات البرنامج

أقسام الإعدادات:

إعدادات الترجمة:

  • اللغة المصدر الافتراضية
  • اللغة المستهدفة الافتراضية
  • محرك الترجمة الافتراضي

إعدادات الأداء:

  • التأخير بين الطلبات (0.0-5.0 ثانية)
  • عدد المحاولات القصوى (1-10)

إعدادات الملفات:

  • ☑️ إنشاء نسخ احتياطية تلقائياً
  • ☑️ تفعيل كاش الترجمة
  • لاحقة ملف الإخراج (_arabic)

إعدادات الواجهة:

  • لغة الواجهة (English/العربية)

أزرار:

  • 💾 Save Settings: حفظ الإعدادات
  • 🔄 Reset to Defaults: إعادة تعيين للافتراضي
  • 📁 Open Config File: فتح ملف الإعدادات

4. 📊 الإحصائيات (Statistics)

الغرض: عرض إحصائيات الاستخدام

إحصائيات الجلسة:

  • عدد الملفات المترجمة
  • إجمالي الأحرف
  • متوسط الوقت لكل ملف
  • مدة الجلسة
  • آخر ترجمة

إحصائيات الكاش:

  • حالة الكاش
  • عدد الإدخالات
  • حجم الكاش
  • معدل النجاح
  • آخر تحديث

أزرار:

  • 🔄 Refresh: تحديث الإحصائيات
  • 🗑 Clear Cache: مسح الكاش
  • 📊 Export Stats: تصدير الإحصائيات

🎯 الميزات المتقدمة

1. السحب والإفلات (Drag & Drop)

  • اسحب الملفات مباشرة إلى منطقة الإسقاط
  • دعم ملفات متعددة للمعالجة المجمعة
  • كشف تلقائي لنوع الملف

2. كشف اللغة التلقائي

  • كشف تلقائي للغة النص المصدر
  • دعم لغات متعددة
  • إمكانية التحديد اليدوي

3. نظام الكاش الذكي

  • حفظ الترجمات المتكررة
  • تسريع عملية الترجمة
  • إدارة ذكية للذاكرة

4. دعم تنسيقات متعددة

  • SRT: تنسيق الترجمة الأكثر شيوعاً
  • ASS: تنسيق الترجمة المتقدم
  • VTT: تنسيق ترجمة الويب

5. معالجة الأخطاء

  • رسائل خطأ واضحة
  • إعادة المحاولة التلقائية
  • حفظ النسخ الاحتياطية

📋 دليل الاستخدام خطوة بخطوة

ترجمة ملف واحد:

  1. افتح التبويب "📄 Single File"
  2. اختر الملف:
    • انقر "Browse" واختر ملف الترجمة
    • أو اسحب الملف إلى منطقة الإسقاط
  3. تحديد اللغات:
    • اتركه على "Auto-detect" للكشف التلقائي
    • أو اختر اللغة المصدر يدوياً
    • اختر اللغة المستهدفة
  4. اختر التنسيق:
    • سيتم كشف تنسيق الإدخال تلقائياً
    • اختر تنسيق الإخراج المرغوب
  5. اضبط الخيارات:
    • اختر محرك الترجمة
    • فعّل/أوقف النسخ الاحتياطية والكاش
  6. ابدأ الترجمة:
    • انقر "🚀 Start Translation"
    • راقب شريط التقدم
  7. افتح النتيجة:
    • انقر "📁 Open Output Folder"

المعالجة المجمعة:

  1. افتح التبويب "📁 Batch Process"
  2. أضف الملفات:
    • انقر "➕ Add Files" لإضافة ملفات منفردة
    • انقر "📁 Add Folder" لإضافة مجلد كامل
    • أو اسحب الملفات إلى القائمة
  3. راجع القائمة:
    • تأكد من إعدادات كل ملف
    • احذف الملفات غير المرغوبة
  4. ابدأ المعالجة:
    • انقر "🚀 Start Batch Translation"
    • راقب التقدم لكل ملف

تخصيص الإعدادات:

  1. افتح التبويب "⚙️ Settings"
  2. اضبط إعدادات الترجمة:
    • حدد اللغات الافتراضية
    • اختر محرك الترجمة المفضل
  3. اضبط إعدادات الأداء:
    • قلل التأخير للسرعة
    • زد المحاولات للموثوقية
  4. اضبط إعدادات الملفات:
    • فعّل النسخ الاحتياطية للأمان
    • فعّل الكاش للسرعة
  5. احفظ الإعدادات:
    • انقر "💾 Save Settings"

🔧 استكشاف الأخطاء

مشاكل شائعة وحلولها:

المشكلة: "لا يمكن كشف تنسيق الملف"

  • الحل: تأكد أن الملف بتنسيق .srt أو .ass أو .vtt
  • الحل: تحقق من صحة محتوى الملف

المشكلة: "فشل في الترجمة"

  • الحل: تحقق من اتصال الإنترنت
  • الحل: جرب محرك ترجمة آخر
  • الحل: قلل عدد الطلبات المتزامنة

المشكلة: "الواجهة لا تستجيب"

  • الحل: انتظر انتهاء العملية الحالية
  • الحل: أعد تشغيل البرنامج
  • الحل: تحقق من موارد النظام

المشكلة: "لا يمكن حفظ الملف"

  • الحل: تحقق من صلاحيات الكتابة
  • الحل: تأكد من وجود مساحة كافية
  • الحل: غير مجلد الإخراج

📞 الدعم والمساعدة

معلومات مفيدة:

  • ملفات السجل: تحفظ في مجلد البرنامج
  • ملف الإعدادات: config.json
  • قاعدة بيانات الكاش: translation_cache.db

نصائح للحصول على أفضل النتائج:

  1. استخدم ملفات ترجمة صحيحة التنسيق
  2. فعّل الكاش لتسريع الترجمات المتكررة
  3. اختر التأخير المناسب بين الطلبات
  4. فعّل النسخ الاحتياطية للأمان
  5. راقب الإحصائيات لتحسين الأداء

ملاحظة: هذا البرنامج مجاني ومفتوح المصدر. لا تتردد في المساهمة أو الإبلاغ عن المشاكل!