تصدير إصدار منشور من التوثيق وأرشفته

يصدّر Nibleaf أحدث إصدار منشور ناجح، لا المسودة الحالية. تنسخ كل عملية تشغيل أولًا عملية النشر ذات الحالة READY إلى لقطة تصدير ثابتة غير قابلة للتغيير، بحيث تصف صيغ Markdown وPDF وHTML الثابت، عند اختيارها معًا، المحتوى نفسه.

إنشاء تصدير لمرة واحدة

انشر الموقع وتحقق منه قبل التصدير. ثم افتح إعدادات الموقع ← التصديرات ← إنشاء تصدير، واختر صيغة واحدة على الأقل، وابدأ التشغيل:

• Markdown ZIP للحصول على مصدر قابل للنقل ونقاط تحقق للترحيل. تحقق من ملفات الصفحات، والبيانات الوصفية الأمامية، والتنقل، والأصول المشار إليها.
• PDF للمراجعة أو الاعتماد أو التوزيع المطبوع. تحقق من الخطوط، والشيفرة، والرسومات التخطيطية، وفواصل الصفحات، والنص من اليمين إلى اليسار.
• Static HTML ZIP للاستخدام دون اتصال أو للاستضافة الثابتة المستقلة. تحقق من الروابط الداخلية، والبحث المحلي، والتنقل، وCSS، والأصول المنسوخة من دون Nibleaf.

تنتقل عملية التشغيل عبر PENDING ثم RUNNING ثم حالة نهائية. لا تظهر روابط التنزيل إلا للنواتج ذات الحالة SUCCEEDED، وتنتهي صلاحيتها بعد مدة قصيرة تحددها نسخة Nibleaf. لا تغيّر العملية الفاشلة الموقع المنشور؛ اقرأ سبب الفشل في سجل التشغيل، وصحح السبب، وأنشئ تصديرًا جديدًا.

جدولة لقطات الأرشفة

افتح الجداول، وأنشئ جدولًا ذا اسم، واختر:

• الصيغ المراد إنشاؤها؛
• وتيرة يومية أو أسبوعية أو شهرية؛
• منطقة زمنية من IANA ووقت تشغيل محليًا؛
• عدد عمليات التشغيل المكتملة المراد الاحتفاظ بها؛
• أقصى عمر للاحتفاظ.

استخدم اسمًا من IANA مثل Africa/Lagos، لا إزاحة ثابتة عن UTC. يحسب Nibleaf موعد التشغيل التالي في تلك المنطقة الزمنية، بحيث تحافظ تغييرات التوقيت الصيفي على وقت الساعة المقصود. استخدم التشغيل الآن لاختبار الجدول نفسه تمامًا قبل الاعتماد عليه، ثم تأكد من وجود الناتج في سجل التشغيل.

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

تشغيل عمال التصدير

تتضمن الحاوية المنشورة Chromium لتصيير ملفات PDF. يجب على صور حاويات العامل المبنية من المصدر أو المخصصة تثبيت متصفح متوافق مع Chromium وضبط EXPORT_CHROMIUM_PATH. إذا كان WORKER_QUEUES يقيّد قوائم الانتظار، فأضف export.

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

اختبار التعافي قبل الاعتماد على تصدير

نزّل ناتجًا حديثًا من كل صيغة مطلوبة واختبره خارج لوحة تحكم Nibleaf. بالنسبة إلى Markdown، افحص عينة واستوردها. وبالنسبة إلى HTML الثابت، قدّم الدليل المستخرج محليًا واتبع الروابط العميقة في أثناء عدم الاتصال. وبالنسبة إلى PDF، راجع صفحات تمثيلية طويلة ومتعددة اللغات وكثيفة الرسومات التخطيطية والشيفرة.

سجّل إصدار النشر، وعملية التصدير، وموقع التخزين، والمسؤول عن الاستعادة. الناتج الذي لم يُفتح قط افتراض غير مختبَر، وليس خطة تعافٍ.