اختر مسارك مع Nibleaf

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

اختر Nibleaf Cloud أو الاستضافة الذاتية

Nibleaf Cloud

اختر Nibleaf Cloud عندما تريد تقييم المنتج أو بدء الكتابة من دون أعمال بنية تحتية.

• ما تديره أنت: محتواك وإعدادات فريقك.
• ما تديره Nibleaf: التطبيق والخدمات المساندة.

الاستضافة الذاتية

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

• ما تديره أنت: DNS وTLS وPostgres وDragonfly وتخزين الكائنات والبريد الإلكتروني والنسخ الاحتياطية والمراقبة والترقيات.
• ما توفره Nibleaf: مصدر التطبيق وصور الحاويات وقوالب Compose وأدوات التثبيت.

خدمة Cloud في مرحلة تجريبية مجانية. وهي لا تقدم حاليًا التزامًا مؤسسيًا بوقت التشغيل أو الدعم. تمنحك الاستضافة الذاتية تحكمًا تشغيليًا، لكنها لا تقلل مسؤولياتك التشغيلية. راجع القيود المعروفة قبل اختيار أي من المسارين لأعباء العمل الحساسة.

افهم المسودات والإصدارات المنشورة

يخزن Nibleaf شجرة الصفحات النشطة ومسودات Markdown في Postgres. يؤدي اختيار Publish (النشر) إلى إنشاء مهمة لعملية النشر. يثبّت العامل المحتوى والإعدادات الحالية في لقطة ثابتة ذات إصدار، ولا يعلن جاهزيتها إلا بعد نجاح المهمة. ويستمر القراء في تلقي آخر إصدار جاهز بينما يجري إنشاء إصدار جديد.

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

حدد اختبارًا لأول نجاح

قبل استيراد قاعدة معرفية كبيرة، انشر مشروعًا من صفحتين:

1. اكتب مقدمة تحدد الجمهور والنتيجة التي يستطيع تحقيقها.
2. أضف صفحة ثانية ضمن مجموعة واربط بها من المقدمة.
3. عاين الصفحتين وانتظر حتى تعرض حالة الحفظ التلقائي Saved (تم الحفظ).
4. انشر مرة واحدة.
5. افتح الموقع العام بعد تسجيل الخروج، وابحث عن عبارة من الصفحة الثانية، واطلب عنوان URL غير موجود للتأكد من ظهور استجابة 404 حقيقية.

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

اعرف أين توجد الحقيقة المرجعية للمنتج

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

استخدم مواصفات API المعروضة على /docs في خدمة API لمعرفة مسارات الخادم الدقيقة. واستخدم .env.production.example للاطلاع على القائمة الكاملة لإعدادات الإنتاج.