مدقق بنية JSON-LD

خطوات الاستخدام

الخطوة الأولى: فهم ما هو JSON-LD. JSON-LD (JavaScript Object Notation for Linked Data) هو تنسيق يستخدم لربط البيانات على الويب بطريقة منظمة وقابلة للقراءة آليًا. يعتمد على JSON ولكنه يضيف سياقًا (context) يربط المصطلحات بكيانات في قاعدة معرفة (مثل schema.org). للتحقق من صحة بنية JSON-LD، يجب أولاً فهم مكوناتها الأساسية: @context، @type، وغيرها من الحقول الخاصة. أدخل النص الذي تريد التحقق منه في حقل الإدخال. تأكد من أن النص يتبع قواعد JSON الصارمة (مثل استخدام الأقواس المعقوفة وعلامات التنصيص المزدوجة).

الخطوة الثانية: تحليل الإدخال. عند الضغط على زر 'تحقق'، سيقوم البرنامج بمحاولة تحليل النص الذي أدخلته باستخدام محلل JSON قياسي (مثل JSON.parse في JavaScript). إذا فشل التحليل، فهذا يعني أن النص ليس JSON صالحًا، وسيتم عرض رسالة خطأ توضح سبب الفشل (مثل خطأ في الصياغة أو وجود حرف غير متوقع). إذا نجح التحليل، يتم بعد ذلك التحقق من وجود الحقول الأساسية لـ JSON-LD: يجب أن يحتوي الكائن على خاصية @context (ويفضل أن تكون قيمة صالحة مثل رابط أو كائن)، وخاصية @type واحدة على الأقل. كما يتم التحقق من أن جميع القيم مضمنة بشكل صحيح (مثل الأقواس للمصفوفات).

الخطوة الثالثة: تفسير النتيجة. بعد التحليل، سيعرض البرنامج حالة النجاح أو الفشل. إذا كان النص JSON-LD صالحًا، فستظهر رسالة نجاح مع تفصيل بسيط مثل 'JSON-LD صالح'. إذا كان غير صالح، فسيتم عرض رسالة خطأ مفصلة. على سبيل المثال: 'خطأ في التحليل: رمز غير متوقع عند السطر 2، العمود 10' أو 'ينقص @context'. عليك مراجعة النص وفقًا للخطأ لتصحيحه. تذكر أن JSON-LD يجب أن يكون أيضًا JSON صالحًا، لذا يجب إصلاح أي أخطاء نحوية أولاً.

الأسئلة الشائعة

JSON (JavaScript Object Notation) هو تنسيق خفيف لتبادل البيانات يعتمد على أزواج المفتاح-القيمة والمصفوفات. يمكن لأي نص JSON صحيح أن يقرأه أي محلل JSON. أما JSON-LD فهو تطور لـ JSON يضيف دلالات (semantics) من خلال ربط البيانات بمفاهيم في قواعد المعرفة (مثل schema.org). بمعنى آخر، كل JSON-LD هو JSON صالح، ولكن ليس كل JSON صالح هو JSON-LD. مدقق JSON العادي يتحقق فقط من الصياغة النحوية (syntax) ، بينما مدقق بنية JSON-LD يتحقق بالإضافة إلى ذلك من وجود الحقول المطلوبة مثل @context و@type، والتأكد من أن @context يشير إلى مورد صالح (مثل رابط يمكن الوصول إليه أو قيمة مناسبة). كما قد يتحقق من أن @type يتوافق مع أنواع معروفة في ذلك السياق. لذلك، استخدام مدقق JSON-LD ضروري للتأكد من أن البيانات المنظمة (structured data) التي تنشرها على موقعك (خاصة لتحسين محركات البحث) ستكون مفهومة لمحركات البحث والأدوات الأخرى التي تفهم JSON-LD. على سبيل المثال، إذا كتبت كائن JSON يصف حدثًا ولكن نسيت إضافة @context و@type، فلن تتعرف عليه محركات البحث كبيانات منظمة.

الأخطاء الشائعة تنقسم إلى نوعين: أخطاء في JSON (صياغة) وأخطاء في بنية JSON-LD (الدلالات). أولاً، أخطاء JSON: الفواصل الزائدة كما في المثال السابق، استخدام علامات تنصيص مفردة بدلاً من مزدوجة، عدم توازن الأقواس، وجود تعليقات (مثل //) لأن JSON لا يدعم التعليقات، استخدام أرقام كبيرة جدًا خارج النطاق المسموح، أو وجود أحرف غير مسموح بها في السلاسل النصية (يجب ترميزها مثل "). ثانيًا، أخطاء بنية JSON-LD: غياب @context أو @type، وضع @context بقيمة غير سلسلة نصية (string) أو كائن (object) غير صالح (مثلاً رقم)، استخدام @context يشير إلى رابط غير صالح (لا يمكن تفعيله)، استخدام @type غير موجود في السياق، أو وضع قيم أنواع خاطئة (مثل وضع نص بدلاً من رقم للعمر). للتصحيح: استخدم أداة تحرير JSON لتنسيق النص وتسليط الضوء على الأخطاء. تحقق من أن @context رابط صحيح (يفضل أن يبدأ بـ https). تأكد من أن كل @type يتوافق مع نوع معرف في schema.org إذا كنت تستخدمه. كما يمكنك استخدام أداة اختبار البيانات المنظمة من Google لتفحص بنية JSON-LD بعد التأكد من صحتها نحويًا.

JSON-LD هو الشكل الموصى به من قبل Google لوضع البيانات المنظمة (structured data) على صفحات الويب. تساعد البيانات المنظمة محركات البحث على فهم محتوى الصفحة بشكل أفضل، مما يمكن أن يؤدي إلى ظهور نتائج غنية (rich snippets) مثل تقييمات النجوم، الأسعار، أو تفاصيل الأحداث في نتائج البحث. لتحقيق ذلك، تحتاج إلى كتابة كود JSON-LD يحتوي على @context (عادة https://schema.org) و@type مناسب للمحتوى (مثل Article, Product, Event, LocalBusiness, ...) بالإضافة إلى الخصائص ذات الصلة. بعد كتابة الكود، يجب التأكد من صحته باستخدام مدقق بنية JSON-LD. المدقق يضمن أن الكود صالح نحويًا ودلاليًا، مما يقلل من فرص رفض Google للبيانات المنظمة. ثم يمكنك اختبار الكود باستخدام أداة اختبار البيانات المنظمة من Google (Rich Results Test) للتأكد من أنه سيظهر كنتائج غنية. على سبيل المثال، إذا كنت تملك موقعًا يبيع منتجات، فاستخدم @type Product مع خصائص name, description, offers (السعر والعملة). إذا كنت تنشر مقالًا، فاستخدم Article مع headline, author, datePublished. تذكر أن البيانات المنظمة يجب أن تكون مطابقة لمحتوى الصفحة الفعلي. المدقق يساعدك على اكتشاف الأخطاء مبكرًا قبل النشر، مما يوفر عليك عناء إعادة الزحف (crawl) لاحقًا.

الثلاثة هي طرق لوضع البيانات المنظمة في صفحات الويب. Microdata تستخدم سمات HTML (مثل itemscope, itemtype, itemprop) لتضمين البيانات في الكود نفسه. RDFa (Resource Description Framework in Attributes) تضيف سمات إضافية مثل typeof, property لربط البيانات. JSON-LD، من ناحية أخرى، تضم البيانات في علامة <script> منفصلة عن HTML، مما يجعل الكود أنظف وأسهل للصيانة ولا يؤثر على تخطيط الصفحة. توصي Google حاليًا باستخدام JSON-LD لأنه الأكثر سهولة، لا يتداخل مع HTML، ويدعم ميزات متقدمة مثل @graph و@id بسهولة. كما أن JSON-LD أكثر قابلية للقراءة من قبل المطورين وأسهل للتحليل البرمجي. لذلك، يُفضل استخدام JSON-LD لتحسين SEO. أما بالنسبة للمدقق، فكل نوع له مدققه الخاص: مدقق بنية JSON-LD يتحقق من صياغة JSON-LD، بينما توجد أدوات مثل مدقق البيانات المنظمة من Google التي تتحقق من جميع الأنواع. إذا كنت تستخدم Microdata، فأنت بحاجة إلى مدقق HTML/Microdata منفصل. لذا، اعتماد JSON-LD يبسط العملية ويسمح باستخدام مدقق مخصص بسيط مثل هذا.

مدقق بنية JSON-LD

أدخل القيم

خطوات الاستخدام

أمثلة محلولة

أمثلة محسوبة

الأسئلة الشائعة

أدخل القيم

خطوات الاستخدام

حاسبات ذات صلة

2مثال 2: JSON-LD غير صالح بسبب خطأ في الصياغة. أدخل النص: {"@context": "https://schema.org", "@type": "Person", "name": "أحمد", "age": 30,} لاحظ الفاصلة الزائدة بعد آخر عنصر (بعد 30). ماذا يحدث؟

أمثلة محسوبة

الأسئلة الشائعة