سند — محرّر توثيق

المشكلة

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

الفكرة

إبقاء التوثيق ملفات Markdown داخل المستودع نفسه، وبناء موقع ثابت منها آليًا عند كل تحديث، مع فهرس بحث يُولَّد وقت البناء بدل الاعتماد على خدمة بحث خارجية.

أهم الخصائص

• توليد الموقع كاملًا من مجلد Markdown واحد.
• بحث فوري يعمل في المتصفح دون خادم.
• قائمة جانبية تُبنى تلقائيًا من هيكل المجلدات.
• روابط ثابتة للعناوين تسهّل الإحالة.
• دعم كامل للعربية واتجاه النص من اليمين لليسار.

التقنيات المستخدمة

• Astro
• TypeScript
• Markdown
• Pagefind

البنية التقنية

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