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

دليل المستودع: مدقق Schema.org وJSON-LD العربي والتحقق من الكيانات

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

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

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

Build an Arabic-focused Schema.org JSON-LD linter in pure Python. It must validate: 1) UTF-8 encoding and character escaping for Arabic text, 2) Schema.org Organization, LocalBusiness, Product, and FAQPage schemas, 3) Middle East specific business fields (taxID, vatID, addressCountry, telephone E.164). Include 12 pre-tested JSON-LD templates.

لمن صُمم؟

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

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

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

  • LICENSE
  • README.md
  • src/schema_linter.py
  • templates/ecommerce-product-salla-zid.json
  • templates/local-business-ksa-eg.json
  • templates/organization-bilingual.json
  • tests/test_linter.py

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

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

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

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

  • Valid Schema.org Types: Validates standard schema vocabularies including Organization, LocalBusiness, Product, and FAQPage.
  • Arabic UTF-8 & Right-to-Left Encoding: Ensures JSON-LD entity names, descriptions, and localized strings are properly formatted in UTF-8 without corrupting Arabic characters.
  • MENA Regional Business Identifiers: Supports regional business fields such as VAT registration (taxID), commercial registration numbers, and E.164 regional phone formats.

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

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