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

دليل المستودع: مدقق إعدادات hreflang ثنائية اللغة لنطاقات الشرق الأوسط وشمال أفريقيا

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

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

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

Build a Python CLI (hreflang_validator.py) that audits bilingual Arabic/English XML sitemaps: 1) Validates language and country codes against official ISO 639-1 and ISO 3166-1 registries (strictly rejecting non-existent codes like zz-xx), 2) Enforces reciprocal bidirectional return links across URLs, 3) Treats x-default as an optional fallback in full alignment with official Google Search Central guidelines, 4) Generates structured JSON audit reports.

لمن صُمم؟

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

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

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

  • data/mena_iso_locales.json
  • examples/audit_output.json
  • examples/sample_sitemap.xml
  • LICENSE
  • README.md
  • src/hreflang_validator.py
  • tests/test_validator.py

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

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

أمثلة أوامر البدء من README: python -m unittest discover -s tests · python src/hreflang_validator.py --sitemap examples/sample_sitemap.xml

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

  • Official ISO Code Verification: Codes must strictly exist in the official ISO 639-1 (language) and ISO 3166-1 alpha-2 (country) registries. Formats matching regex ^[a-z]{2}-[a-z]{2}$ but with fake entries (e.g. zz-xx) are flagged as fatal errors.
  • Hreflang Reciprocal Confirmation: If Page A links to Page B via an alternate hreflang annotation, Page B must link back to Page A; missing return links cause search engines to disregard annotations.
  • Optional x-default: In accordance with Google Search Central guidelines, x-default is recommended for unmatched landing pages, but its absence is never flagged as an error.

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

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