ضبط قواعد إعادة التوجيه والتحقق منها

تُضبط عمليات إعادة التوجيه لكل موقع من المحرر ← إعداد الموقع ← عمليات إعادة التوجيه. وهي جزء من لقطة نشر ثابتة غير قابلة للتغيير: لا يؤدي تعديل إعادة توجيه إلى تغيير الموقع الحي حتى عملية النشر الناجحة التالية.

المصادر والوجهات المقبولة

• المصدر مسار نسبةً إلى الموقع مثل /old-guide. لا تُدرج بادئة تطبيق Nibleaf (/sites/<project-id>) أو نطاقًا مخصصًا أو سلسلة استعلام أو جزءًا من الرابط.
• تُطبَّع الشرطات المائلة في البداية والنهاية. وتُعامل أحرف Unicode المرمّزة بالمئة مثل مكافئها بعد فك الترميز. تُرفض مقاطع النقاط والشرطات المائلة العكسية وأحرف التحكم وتسلسلات الهروب المئوية غير الصالحة وفواصل المسارات المرمّزة.
• الوجهة الداخلية مسار نسبةً إلى الموقع، ويمكن أن تتضمن سلسلة استعلام وجزءًا من الرابط، مثل /guide?lang=ar#install.
• يجب أن تكون الوجهة الخارجية رابطًا مطلقًا يبدأ بـhttp:// أو https:// ويتضمن اسم مضيف. تُرفض الروابط النسبية للبروتوكول وبيانات الاعتماد المضمّنة في الروابط والمخططات الأخرى.
• يجب أن تكون المصادر فريدة بعد التطبيع، ولا يجوز أن تشير إلى نفسها أو تتعارض مع صفحة منشورة أو اسم بديل لمجموعة/جذر أو مسار إصدار أو مسار موقع محجوز.

سلوك الرسم البياني والنشر

• يمكن للموقع تخزين 100 قاعدة إعادة توجيه كحد أقصى.
• يمكن أن تتضمن السلاسل الداخلية 10 انتقالات كحد أقصى، ويجب ألا تحتوي على دورات.
• عند النشر، تُحل كل سلسلة داخلية إلى صفحتها النهائية القابلة للتصيير. تخزّن اللقطة إعادة توجيه مباشرة، بما في ذلك الحل وفق الرابط الأساسي للأسماء البديلة للمجموعة/الجذر وبادئات الإصدارات غير الافتراضية.
• بالنسبة إلى وجهة داخلية نهائية، تكون سلسلة الاستعلام والجزء من الرابط اللذان ضُبطا صراحةً أخيرًا في السلسلة هما النافذين؛ وتُحتفظ قيمة سابقة عندما لا تستبدلها انتقالات لاحقة. أما الوجهة الخارجية النهائية فتُصدَر كما ضُبطت تمامًا.
• يجب أن يسمّي استعلام lang المضبوط لغة مفعّلة، وأن توجد الوجهة بتلك اللغة. من دون lang صريح، يستخدم التحقق اللغة الافتراضية؛ ويحافظ القارئ على اللغة الحالية للزائر عند إصدار إعادة التوجيه.
• ليست الصفحات المخفية واللغات المعطلة والصفحات المحذوفة والمسارات غير الموجودة في اللقطة الفعلية وجهات داخلية صالحة. استخدم رابطًا خارجيًا مسموحًا عندما تغادر الوجهة الموقع عمدًا.
• تستخدم استجابات إعادة التوجيه حالة HTTP الدائمة 308، مع الحفاظ على طريقة الطلب الأصلية وفق سلوك الموقع المنشور الحالي.

يبلغ المحرر عن أخطاء الصياغة والرسم البياني قبل الحفظ. ويجري مربع حوار النشر فحصًا تمهيديًا واعيًا بالمسارات مقابل الصفحات واللغات والإصدارات الفعلية. وتكرر API ذلك الفحص قبل إنشاء عملية نشر، ثم يتحقق العامل مرة أخرى مباشرةً قبل تعيين حالة اللقطة إلى READY. يترك أي فشل عملية النشر السابقة ذات الحالة READY حية؛ ولا يُنشر أي ضبط جزئي لإعادة التوجيه.

ملاحظات المحرر والنشر

شاهد تفاعل التحقق من إعادة التوجيه ومدته 20 ثانية لترى تحديث الملاحظات على مستوى الصف في أثناء إدخال دورة.

تُقبل السلسلة الداخلية الصالحة في المحرر. وتُسطّح إلى عمليات إعادة توجيه مباشرة في اللقطة الثابتة غير القابلة للتغيير أثناء النشر.

تبرز الدورات كل صف مشارك وتعرض تسلسل المسار كاملًا قبل الحفظ.

يتكرر التحقق الواعي بالمسارات في مربع حوار النشر. يظل النشر معطلًا حتى يصبح الرسم البياني صالحًا، ولذلك تبقى عملية النشر الحالية ذات الحالة READY حية.