محمود عبدالنبي
أنظمة المحتوى · أداة سطر أوامر · 2

دليل المستودع: مدقق الترجمة النصية المتحركة لإعلانات السوشيال العربية

صفحة تعريفية مستقلة بمستودع مدقق الترجمة النصية المتحركة لإعلانات السوشيال العربية. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.

المشكلة التي يعالجها

يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:

Develop a pure Python subtitle validation tool for Arabic and English social video (subtitle_linter.py): 1) Parses SRT and VTT files, 2) Flags subtitles exceeding recommended reading speed (>160 WPM), 3) Checks maximum characters per line (flagging >38 chars on mobile), 4) Detects reversed punctuation marks in Arabic bidirectional text, 5) Outputs an automated correction report.

لمن صُمم؟

الجمهور المحدد في README: PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

محتويات المستودع

الملفات الأساسية التي يسردها قسم بنية المستودع في README:

  • docs/arabic-subtitle-best-practices.md
  • examples/bad_subtitles.srt
  • examples/fixed_subtitles.srt
  • guidelines/mobile-subtitle-standards.md
  • LICENSE
  • README.md
  • src/subtitle_linter.py
  • tests/test_linter.py
  • tests/test_subtitles.py

طريقة مراجعته واستخدامه

  1. ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
  2. افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
  3. اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
  4. قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.

أمثلة أوامر البدء من README: python -m unittest discover -s tests · python src/subtitle_linter.py --help

النطاق والقيود

  • Arabic Glyph Shaping & BiDi Integrity: Ensures subtitle renderers do not detach Arabic letters or reverse character sequences when applying kinetic motion effects.
  • Words-Per-Screen Limits: Caps subtitle chunks at 3 to 5 words to maintain readability during fast-paced social video narration.
  • Contrast & Shadow Enclosure: Mandates text drop shadows or contrasting backdrop bars to prevent white text from disappearing on bright video backgrounds.

هذه الصفحة تلخص التوثيق المتاح ولا تثبت أداءً أو نتيجة تجارية. تحقق من صلاحية البيانات والمتطلبات قبل الاستخدام.

مستودعات مرتبطة