مختبر ترحيل التوثيق وتحويل SEO

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

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

عرّف النجاح ومصدر الحقيقة

سمِّ المصدر الحالي والوجهة والمراجعة المرشحة ونافذة القطع. اختر المصدر الذي يقبل الكتابة أثناء كل مرحلة. إذا بقي نظامان قابلين للتحرير بلا مزامنة مثبتة، ستتباعد النسختان.

عرّف النجاح على مستوى السلوك:

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

المرحلة 1: ابن جرد الروابط والمحتوى

اجمع عناوين URL من sitemap الحالية وتحليلات موثوقة وسجلات الخادم والروابط الداخلية وملفات المصدر. لا تعامل sitemap وحدها كجرد كامل؛ قد تفتقد صفحات قديمة ما زالت تتلقى روابط.

استخدم جدولاً يحتوي على:

الحقل	الغرض
الرابط القديم	هوية المصدر التي تحتاج تحويلاً أو قرار حذف
الرابط الجديد	canonical المقصود
اللغة	en أو ar مثلاً
الحالة	عام أو noindex أو خاص أو محذوف
العنوان والوصف	مقارنة البيانات الوصفية
owner	من يقرر عند الغموض
الأدلة	crawl أو analytics أو backlink أو سجل دعم

أزل الأسرار ومعرفات العملاء من العينات. سجّل المجهول كمجهول، ولا تخترع رابطاً بديلاً فقط لملء الخلية.

المرحلة 2: حوّل المحتوى بصورة حتمية

حدد mapping لكل نوع: عنوان، فقرة، قائمة، جدول، شيفرة، تنبيه، تبويب، صورة، رابط، وبيانات frontmatter. اجعل المحول يعيد النتيجة نفسها عند التشغيل المتكرر.

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

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

اجرد الأصول مستقلة عن الصفحات. حل المسارات النسبية، واحفظ alt ونوع MIME، وانسخ كائنات Git LFS لا ملفات المؤشر فقط. أنشئ خريطة روابط متعددة اللغات فيها اللغة والرابط القديم والجديد وcanonical والنظير المترجم ونتيجة التحويل. اختبر أن slug العربي يدور عبر الترميز وفكه من دون فساد، ولا تفرض slug الإنجليزية على الترجمة.

المرحلة 3: صمم التحويلات وcanonical

يحتاج كل رابط قديم إلى أحد القرارات: تحويل 301/308 إلى نظير، إبقاء canonical نفسه، أو 410 لحذف مقصود بلا بديل. لا تحول كل المفقود إلى الصفحة الرئيسية؛ هذا يخفي الأخطاء ويعطي القارئ إجابة غير ذات صلة.

تحقق من:

• عدم وجود سلاسل أو حلقات؛
• الحفاظ على المسار والاستعلام عندما يكون لهما معنى؛
• عدم تحويل صفحة عربية إلى إنجليزية إذا كان النظير العربي موجوداً؛
• تطابق canonical مع URL النهائي؛
• تحديث الروابط الداخلية إلى الوجهة النهائية لا إلى رابط قديم.

المرحلة 4: تدرّب على hostname مؤقت

انشر النسخة المرشحة على نطاق تجريبي محمي من الفهرسة. استخدم نسخة بيانات منزوعة الحساسية، ولا تفتح المحتوى الخاص لمجرد تسهيل الاختبار.

شغّل crawler على الجرد، ثم اعرض مجموعة ممثلة بمتصفح حقيقي على سطح المكتب والهاتف. افحص RTL والقوائم والجداول والشيفرة وfocus، ولا تكتفِ بـHTML الخام.

قارن HTML وMarkdown لكل صفحة عامة. يجب أن يكون المحتوى جوهرياً متكافئاً، وأن تفشل الصفحات الخاصة وnoindex بصورة مغلقة.

المرحلة 5: جهز حزمة القطع

تتضمن الحزمة:

1. SHA أو digest المرشح ونتائج الفحوص.
2. خريطة التحويلات المجمدة وعدد صفوفها.
3. نسخة قاعدة البيانات والأصول وطريقة الاستعادة.
4. قائمة تغييرات DNS وTTL والمالك.
5. لوحة المراقبة ومسباراً خارجياً.
6. شروط go/no-go والتراجع.
7. قناة اتصال ومسؤول قرار واحداً.

لا تضع مفاتيح أو tokens في الحزمة. اربط إلى مخزن أسرار بدلاً منها.

المرحلة 6: جمّد واُصدر واقطع

أعلن تجميد الكتابة ثم تأكد أنه فعلي. خذ التصدير النهائي بعد التجميد، وشغّل التحويل الحتمي، وانشر الهوية المجربة نفسها. نفذ تغييرات DNS أو الوكيل كما في التدريب.

بعد القطع مباشرة افحص من شبكة خارجية: TLS، الصفحة الرئيسية، صفحات EN وAR، صورة، بحث، sitemap، Markdown، 404، وتحويلات عالية القيمة. سجّل timestamps والهوية التي أجابت.

المرحلة 7: راقب واتخذ القرار

راقب معدلات 4xx/5xx، والتحويلات المفقودة، وزمن الاستجابة، وسجل البحث، وفشل الصور والنشر. لا تفسر انخفاض الطلبات فوراً كتحسن؛ قد يكون القياس نفسه انقطع.

قارن النتائج بخط الأساس وبشروط القرار المكتوبة. لا توسع النطاق أو تحذف النظام القديم قبل انقضاء فترة التحقق والاستعادة.

شروط التراجع وآليته

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

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

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

متى تكون GitBook أو Mintlify أو Docusaurus أو Starlight وجهة أفضل؟

اختر Docusaurus أو Starlight عندما يكون Git هو السلطة والخرج الثابت هدفاً. قد يكون GitBook أنسب للتعاون المُدار، وMintlify لتوثيق مطورين قائم على Git. لا تجعل نجاح المستورد هو المعيار الوحيد؛ قارن العمل اليومي والتصدير والتشغيل والوصول.

تطبيق المختبر على Nibleaf

يدعم Nibleaf استيراد Markdown ونشر لقطات وروابط canonical وhreflang وsitemap وتصديراً. اختبر ذلك على المراجعة أو الصورة المرشحة؛ قد تختلف قدرات main عن الإصدار العام. أثبت عزل tenants والصفحات الخاصة في المصدر والوجهة.

المراجع وتاريخ المراجعة

رُوجعت المراجع في 2026-09-03: إرشادات Google لنقل المواقع، إعادة التوجيه في Google، RFC 9110، وإرشادات Docker Compose للإنتاج.