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

دليل المستودع: رادار عناوين البريد ثنائية اللغة ومقتطفات صندوق الوارد

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

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

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

Create an open-source bilingual subject line and preheader inspection tool: 1) Python CLI (subject_linter.py) auditing character length (desktop vs mobile truncation limits), preheader padding characters (‌ ), and bidirectional Unicode mark isolation, 2) Curated list of 150+ Arabic spam trigger words, 3) Interactive HTML mobile inbox preview card.

لمن صُمم؟

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

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

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

  • data/arabic_spam_triggers.json
  • data/spam_triggers_ar_en.json
  • examples/sample_subject_lines.csv
  • examples/sample_subject_tests.json
  • LICENSE
  • README.md
  • reports/inbox_preview_simulator.html
  • src/subject_line_analyzer.py
  • src/subject_linter.py
  • tests/test_analyzer.py
  • tests/test_linter.py
  • tests/test_subject.py

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

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

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

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

  • MIME Encoded-Word Headers: Ensures Arabic subject lines are properly encoded in UTF-8 base64 ('=?UTF-8?B?...?=' per RFC 2047) to avoid character garbling.
  • Mobile Inbox Cutoff Limits: Previews how subject lines and preheaders appear across mobile screens, capping visible characters at 35 to 45 units.
  • Directional Neutrality: Enforces Unicode directional marks to prevent bracket displacement when English brand names appear in Arabic subject lines.

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

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