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

دليل المستودع: حزمة تحسين أداء الخطوط وتحميلها لمواقع الويب العربية

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

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

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

Build an open-source Arabic web font optimization toolkit with example @font-face CSS, a Python glyph subsetting script, and guidance for measuring Core Web Vitals. The included snippet is not production-tested across all listed fonts, and no fixed file-size reduction is guaranteed.

لمن صُمم؟

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

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

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

  • configs/arabic_unicode_ranges.json
  • css/arabic-fonts-performance-reset.css
  • docs/eliminating-cls-arabic-fonts.md
  • LICENSE
  • README.md
  • src/subset_arabic_font.py
  • tests/test_subsetting.py

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

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

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

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

  • FOUT & FOIT Prevention: Uses 'font-display: swap' and targeted preloading of initial Arabic glyph subsets to eliminate invisible text flashing.
  • Variable Font Compression: WOFF2 and glyph subsetting can reduce transfer size; measure the actual source and subset files for each font rather than relying on a universal size target.
  • Baseline Vertical Alignment: Corrects Arabic font vertical metric clipping (ascent/descent) across multi-line headings and buttons.

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

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