يجب أن يحتوي كل عنصر من عناصر JSON على معرف ثابت وسبيكة فريدة وتاريخ نشر وتاريخ تعديل. يجب أن يعلن الملف أيضًا عن إصدار المخطط الخاص به وتاريخ التحديث الخاص به.

تحدد هذه الحقول عقدًا تحريريًا مقترحًا؛ ولا يفرض معيار JSON حقل slug أو تاريخًا.

قرار اتخاذ أولا

إصدار البيانات وهيكلها. إضافة حقل اختياري أمر بسيط ؛ تتطلب إعادة تسمية حقل أو إزالته ترحيلًا صريحًا وتحكمًا في محرك الأقراص وسجلًا يمكن التحقق منه.

طريقة ملموسة

  1. قم بتعيين معرف مستقل عن العنوان غير قابل للتغيير.
  2. احتفظ بالبزاقات المنشورة أو قم بإعداد إعادة توجيه.
  3. فرز المفاتيح باستمرار للحصول على اختلافات مقروءة.
  4. تحقق من التكرارات والأنواع والتواريخ قبل كل التزام.
  5. التسمية في Git دفعات تحريرية مهمة.

الفخ الرئيسي

إعادة استخدام المعرف أو تجديد جميع الرخويات يؤدي إلى حدوث تصادمات ووصلات معطلة وفقدان إمكانية التتبع. يجب ألا تعتمد هوية المقال على حقل قابل للتحرير.

الخطوة التالية موصى بها

اكتب عنصر تحكم CLI يقوم بحساب المقالات ، ويحدد البزاقات المكررة ، ويتحقق من صحة الحقول المطلوبة في كل لغة.

مراجع موثقة لهذا الموضوع

مراجع موثقة لهذا الموضوع
المرجعالقيمة أو الصيغةالنطاق
RFC 8259 · JSON
application/json · UTF-8لا يسمح JSON القياسي بالتعليقات أو الفاصلة الختامية؛ وتستخدم السلاسل علامات اقتباس مزدوجة.
WordPress · Tools Export
WXR / XMLقد يتضمن تصدير محتوى WordPress المقالات والصفحات وأنواع المحتوى والتعليقات والحقول المخصصة والتصنيفات. يتحدد النطاق بالمرشحات المختارة. افحص ملفات الوسائط والقالب والإضافات والإعدادات بصورة منفصلة قبل اعتباره نقلًا كاملًا.
HTTP · If-Match
If-Match: "r7" → 412يقارن If-Match أداة تحقق قوية قبل الكتابة. وفق العقد الموضح، تتلقى النسخة القديمة 412؛ وتُحفظ المسودة لمقارنة التعديلات.

تشير التواريخ إلى الاطلاع على المراجع. هذه المعلومات ليست تدقيقاً للموقع ولا إعلاناً شاملاً عن المطابقة.

ورشة تحقق: دليل قبل اتخاذ القرار

تمرين مقترح ضمن نطاق تختاره، ببيانات افتراضية عند الحاجة. سجّل ما تلاحظه؛ لا يصف السيناريو اختبارًا سبق تنفيذه على موقعك.

إجراء للتجربة

صحح جملة في مقال JSON ضمن نسخة عمل مع إبقاء المعرّف. قارن البيانات ثم أعد توليد الصفحة.

سجل للاحتفاظ به

احتفظ بالفروق ونتيجة محلل JSON والصفحة المعروضة. افحص العنوان والرابط والعلاقات والمحتويات المجاورة.

ما لا يثبته الدليل

قد يكون JSON صحيح البنية ومخطئًا في الوقائع. المعرّف الثابت لا يضمن النشر أو الاستعادة الصحيحين.

التوسع في الطريقة

تغيير يستحق الإصدار

يقوم الفريق بتصحيح وقت الاستجابة المذكور في اثني عشر مقالة JSON. يقوم بتحديث حقيقة المصدر ، ويسجل المعرفات الاثني عشر المتأثرة ، ثم يتحقق من أن العناوين والتواريخ والروابط لم يتم تغييرها عن طريق الخطأ. تُظهر مقارنة الملفات قبل الإصدار بالضبط الإجابات التي تم تحريرها.

احتفظ بمعرف ثابت لكل مقالة وقم بالتحقق من صحة JSON قبل النشر. لا ينبغي أن يؤدي تصحيح الجملة الواحدة إلى إنشاء عنوان URL جديد أو محو محفوظات. سجل سبب إجراء التغيير ومن وافق عليه.

تنظيم محتويات الموقع بمرور الوقت →