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

دليل المستودع: مدقق تنسيق الأرقام العربية واتجاه النصوص ثنائية الاتجاه

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

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

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

Develop a pure Python Arabic numeral and bidirectional text normalization CLI (bidi_linter.py): 1) Scans text and HTML files for mixed Western/Eastern numerals, 2) Automates one-click normalization to either system, 3) Detects phone numbers and currency strings that lack proper <bdi> or Unicode RLM/LRM isolation marks, 4) Outputs a clean terminal report and corrected text files.

لمن صُمم؟

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

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

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

  • docs/unicode-bidi-best-practices.md
  • examples/scrambled_and_fixed_text.html
  • LICENSE
  • README.md
  • src/bidi_linter.py
  • tests/test_bidi.py
  • tools/web_normalizer.html

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

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

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

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

  • Eastern Arabic (٠-٩) vs Western Arabic (0-9) Digits: Enforces numeral consistency within regional markets (Saudi retail predominantly Western 0-9).
  • BiDi Formatting Characters: Injects Unicode Left-to-Right Mark (&lrm; / U+200E) around telephone numbers and prices to prevent displaced currency symbols.
  • Mathematical Operator Placement: Preserves proper visual ordering for percentages (e.g. 50%) and mathematical ranges within RTL sentences.

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

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