ترحيل التوثيق إلى Nibleaf
خطط لترحيل قابل للعكس من Mintlify أو Ghost أو مستودع Markdown عام، ثم تحقق من تكافؤ المحتوى قبل تغيير DNS.
- 3 دقيقة قراءة
- آخر تحديث 22/08/2026
تعامل مع الاستيراد بوصفه تحويلًا، لا دليلًا على التكافؤ. أبقِ المصدر متاحًا، واستورد إلى مشروع مؤقت أو فرع معزول، وعالج كل تحذير، ولا تنقل الزيارات إلا بعد اختبار الزحف والتدرّب على التراجع.
اختيار المصدر
| المصدر | ما يقرأه Nibleaf | ما يجب مراجعته بدقة |
|---|---|---|
| مستودع Mintlify | مستودع GitHub عام، وdocs.json أو mint.json، والتنقل، وMarkdown/MDX، والأصول التي يمكن الوصول إليها، وإعدادات الموقع المدعومة. | المكونات المخصصة، وحاويات التنقل المتداخلة، وعمليات إعادة التوجيه، وروابط الأصول، والإعدادات غير المدعومة. |
| تصدير Ghost | المنشورات المدعومة وبياناتها الوصفية وأصولها من ملف تصدير. | التسلسل الهرمي من المنشور إلى الصفحة، وإسناد اللغة، والمحتوى المضمّن، والأصول البعيدة المفقودة. |
| مستودع Git عام | محتوى Markdown من المزوّد العام والفرع المضبوطين. | جذر المصدر، والترتيب، والبيانات الوصفية الأمامية، وإعادة كتابة الروابط، وتوقعات المزامنة اللاحقة. |
لاستيراد Mintlify، أدخل owner/repository وفرعًا اختياريًا. يفضّل Nibleaf
الملف docs.json، ويقرأ التنقل نسبةً إلى ذلك الملف، ويستورد الصفحات الداخلية
المرتبطة التي أُغفلت من التنقل، ويحافظ على إعدادات الهدف الحالية عندما تكون
معبأة بالفعل. تنشئ عملية الاستيراد الواحدة 500 عقدة تنقل كحد أقصى، بما فيها
المجموعات والصفحات؛ ويجب تقسيم المصادر التي تتجاوز هذا الحد ومطابقة إجمالياتها
قبل التحويل.
لا يقرأ Nibleaf رابط محرّر خاصًا في Mintlify Cloud. إذا لم تكن مساحة العمل مرتبطة بمستودع GitHub عام، فصدّر مصدرها أو انشره أولًا إلى مستودع عام مؤقت، وأزل الأسرار والمحتوى الخاص، ثم استخدم ذلك المستودع للتدرّب على الترحيل.
إنشاء خط أساس
قبل الاستيراد، سجّل:
- مراجعة المصدر أو الطابع الزمني للتصدير؛
- عدد الصفحات والأصول؛
- التسلسل الهرمي للتنقل وعمليات إعادة التوجيه؛
- النطاقات المخصصة، وقواعد الرابط الأساسي (canonical)، والفهرسة، وعلاقات اللغات؛
- عينات تمثيلية من Markdown ومكونات MDX والجداول والرسومات التخطيطية والتنزيلات؛
- استعلامات البحث التي يجب أن تعيد صفحة معينة.
صدّر المصدر أو أنشئ نسخة احتياطية منه، وحدد المسؤول عن التحويل والتراجع.
الاستيراد وفحص التحذيرات
شغّل الاستيراد في مشروع جديد أو فرع معزول. اقرأ الملخص وعالج كل صفحة أو أصل تم تخطيه، وكل اسم مسار مكرر، وكل إعداد غير مدعوم. قد يحتفظ Nibleaf برابط المصدر عندما يتعذر نسخ أحد الأصول؛ ولا يُعد ذلك ترحيلًا دائمًا إذا كان المصدر سيُزال.
ابحث في المصدر المستورد عن أسماء المضيف القديمة، وبادئات /docs، ووسوم
المكونات الخاصة بالمصدر، وبيانات الاعتماد المضمّنة، وروابط الأصول المطلقة.
التحقق من التكافؤ
اتبع هذا الترتيب:
- قارن عدد الصفحات وتسلسلها الهرمي.
- عاين صفحة واحدة لكل نمط محتوى.
- افحص بالزحف الروابط الداخلية والصور والتنزيلات وعمليات إعادة التوجيه والمسارات المفقودة.
- اختبر استعلامات البحث المسجلة في خط الأساس بكل لغة.
- افتح الإعدادات ← اللغات وعالج كل صفحة مفقودة مقارنةً باللغة الافتراضية.
- افحص العنوان والوصف والرابط الأساسي و
hreflangوrobots وخريطة الموقع والبيانات المنظّمة في استجابة HTML الأولية. - تحقق من سلوك لوحة المفاتيح والهاتف المحمول في صفحات تمثيلية.
- انشر إلى اسم مضيف غير أساسي وكرر الفحوص في أثناء تسجيل الخروج.
لا تحذف المصدر أو تغيّر DNS قبل أن تتوفر للبديل نسخة تراجع مختبَرة.
التصدير والتعافي
أنشئ تصدير Markdown قبل ترحيل كبير، وقبل إغلاق مساحة عمل، وبعد التجميد النهائي للمصدر. قابلية نقل Markdown منفصلة عن التعافي من الكوارث؛ إذ يحتاج مشغّلو الاستضافة الذاتية أيضًا إلى نسخ احتياطية متزامنة من Postgres وتخزين الكائنات.
عندما يظل GitHub جزءًا من سير العمل، أكمل إعداد التأليف ثنائي الاتجاه عبر Git في مستودع مؤقت أولًا. عيّن Git أو Nibleaf بوصفه المرجع المعتمد لكل مرحلة، واستخدم فرع تأليف مخصصًا، وتدرّب على حل التعارضات قبل السماح بالتعديل من المتصفح والمستودع معًا. راجع القيود المعروفة للاطلاع على حدود المزوّد والتعافي.