أدوات التوثيق مفتوحة المصدر في 2026: كيف تختار؟

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

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

اجعل قرار المنصة أو المولد صريحاً

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

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

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

ملفات Git أم محرر ويب؟

تعامل أدوات docs-as-code مثل Docusaurus وMkDocs Material وStarlight وFumadocs مع التوثيق كملفات Markdown داخل مستودع. تحصل على التاريخ والفروع والمراجعة نفسها التي يستخدمها المهندسون، لكن كل مساهم يحتاج إلى Git أو إلى طبقة تحرير إضافية.

تخزن منصات المحرر مثل BookStack وWiki.js وNibleaf المحتوى في قاعدة بيانات وتوفر تجربة كتابة داخل المتصفح. هذا يوسع دائرة المساهمين، لكنه يجعل جودة التصدير والاستعادة جزءاً أساسياً من قرار الشراء. قاعدة البيانات ليست مشكلة بحد ذاتها؛ المشكلة أن تكون صيغة الخروج مغلقة أو غير مجربة.

الأدوات السبع في نظرة واحدة

الأداة	نموذج التأليف	البحث	العربية وRTL	الاستضافة	الأنسب لـ
Docusaurus	Git وMarkdown/MDX	Algolia أو إضافات محلية	i18n مدمج وRTL	إخراج ثابت	فرق React مع توثيق ذي إصدارات
MkDocs Material	Git وMarkdown	بحث محلي بمحللات لغوية	عبر إضافة i18n	إخراج ثابت	فرق Python ومشاريع MkDocs القائمة
Starlight	Git وMarkdown/MDX	Pagefind مدمج	توجيه متعدد اللغات وRTL	إخراج ثابت	مواقع Astro السريعة قليلة الإعداد
Fumadocs	MDX داخل التطبيق	Orama أو Algolia	مسارات ومحللات لكل لغة	مع تطبيق Next.js	توثيق جزء من منتج React
BookStack	محرر مرئي أو Markdown	بحث داخلي	واجهة مترجمة وحدود في ربط الترجمات	PHP وMySQL	قواعد المعرفة الداخلية
Wiki.js	عدة محررات وقاعدة بيانات	محركات قابلة للتبديل	مساحات أسماء للغات	Node.js	تثبيتات قائمة تحتاج مزامنة Git
Nibleaf	محرر مرئي يعيد Markdown	Orama ومسارات اختيارية في المصدر	أشجار لغات وواجهة عربية وRTL	سحابة تجريبية أو Docker Compose	فرق مختلطة تريد تحريراً مرئياً وملكية Markdown

مولدات docs-as-code

Docusaurus

Docusaurus خيار عملي للفرق الهندسية التي تحتاج إصدارات وثائق وMDX ونظام إضافات واسعاً. يملك نظام i18n ناضجاً ويدعم لغات RTL. الكلفة هي بناء أثقل من بعض البدائل، وحاجة التخصيص إلى React. لا تفترض أن Algolia جزء مجاني من كل مشروع؛ تحقق من أهلية DocSearch أو اختر بحثاً محلياً.

MkDocs Material

يقدم MkDocs Material إعداداً واضحاً عبر YAML وبحثاً محلياً جيداً، ويظل مناسباً خصوصاً لفرق Python. أعلنت الجهة المطورة أن 9.7.0 كان آخر إصدار ميزات وأن العمل انتقل إلى Zensical المتوافق مع ملفات mkdocs.yml. للمشروع القائم، تحقق من نافذة الإصلاحات. للمشروع الجديد، قيّم الاثنين معاً.

Starlight

يجمع Starlight بين إخراج Astro السريع وPagefind المدمج ودعم التوجيه متعدد اللغات وRTL. يناسب فريقاً يريد موقعاً ثابتاً بتهيئة محدودة. منظومة الإضافات أصغر من Docusaurus، وتوثيق الإصدارات يعتمد عادة على المجتمع لا على ميزة أساسية.

Fumadocs

اختر Fumadocs عندما يجب أن يعيش التوثيق داخل تطبيق Next.js أو React ويشارك مكوناته ونظامه البصري. يمنحك مرونة كبيرة وبحث Orama، لكنه إطار تتوقع معه كتابة React وصيانة التكامل داخل تطبيقك.

منصات المحرر المرئي

BookStack

BookStack موسوعة PHP/Laravel واضحة ببنية كتب وفصول وصفحات، ومحررين مرئي وMarkdown، وبحث مدمج وخيارات دخول مؤسسية. قوته في المعرفة الداخلية. لا يملك نموذجاً متكاملاً لربط نسخ المحتوى المترجمة، وتحتاج تجربة RTL إلى اختبار واقعي قبل اعتماده لموقع منتج عربي.

Wiki.js

يوفر Wiki.js عدة محررات وخيارات بحث ودخول ومزامنة ثنائية مع مستودع Git. الإصدار المستقر 2.5.x مناسب للتثبيتات القائمة، لكن مسار الإصدار 3 طويل وغير محدد الموعد. افصل بين صلاحية الاستمرار على تثبيت قائم وقرار بدء مشروع جديد.

Nibleaf

Nibleaf مشروع AGPL-3.0 يحاول الجمع بين محرر كتلي داخل المتصفح وMarkdown قابل للتصدير. يحفظ المحتوى النصي، وينشئ لقطات نشر غير قابلة للتغيير حتى لا يرى القارئ مسودة قيد التحرير. يوفر البحث الافتراضي عبر Orama، وأشجار صفحات لكل لغة، وواجهة عربية، وRTL، وhreflang، ونطاقات مخصصة.

يتكون النشر الذاتي من التطبيق وAPI وعامل خلفي وPostgreSQL وذاكرة تخزين مؤقت متوافقة مع Redis وتخزين كائنات. هذا أكبر تشغيلياً من مولد ثابت. كما أن ميزات موجودة في فرع المصدر main قد لا تكون داخل صورة الإصدار العامة المثبتة؛ سمِّ SHA أو digest قبل المقارنة.

كيف تحسم الاختيار؟

• إذا كان المهندسون يكتبون داخل Git، اختبر Docusaurus للإصدارات والمنظومة، وStarlight للبساطة والسرعة ودعم اللغات.
• إذا كان التوثيق جزءاً من تطبيق Next.js، اختبر Fumadocs.
• إذا كان لديك مشروع MkDocs مستقر، لا تهاجر لمجرد ظهور بديل؛ قارن كلفة البقاء بخطة Zensical.
• إذا كان المطلوب قاعدة معرفة داخلية، اختبر BookStack قبل منصات المنتج الأوسع.
• إذا كان غير المطورين يكتبون باستمرار أو كانت العربية وRTL شرطاً، اختبر Nibleaf مع تصدير واستعادة حقيقيين.

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

المراجع راجعت في 2026-09-03: توثيق Docusaurus، توثيق Starlight، Git Sync في GitBook، وتوثيق Mintlify. قد تتغير المنتجات والأسعار؛ تحقق من المصدر والإصدار الذي ستستخدمه.