من مجلد content/ إلى الصفحة: مصدر واحد للحقيقة في موقع ثابت

أحب المواقع التي تعرف أين «الحقيقة» لكل مقال: ملف Markdown واحد، front matter صريح، وباقي التطبيق يقرأ ويعرض. هذا يقلل الصدمات عند النشر: لا قاعدة بيانات مخفية، ولا نسختان من نفس النص يتصارعان. مجلد مثل content/ ليس مجرد مكان تخزين؛ هو عقد بينك وبين مشروعك يقول إن أي تعديل يبدأ من هنا.

لماذا الملفات أحيانًا أفضل من لوحة تحكم؟

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

تسمية الملفات والتواريخ

استخدم slugs إنجليزية واضحة للروابط، وعناوين عربية داخل الـ YAML إن رغبت. التاريخ في الـ front matter يساعدك على ترتيب المدونة دون الاعتماد على تاريخ إنشاء الملف وحده. الاتساق أهم من الذكاء المبالغ في التسمية؛ عقلك المستقبلي سيرسل لك تحية.

ما الذي يجب ألا تضعه في Markdown؟

تجنّب أسرار API، بيانات شخصية لأشخاص آخرين، أو منطقًا حساسًا يجب أن يبقى في الخادم فقط. Markdown للنص والهيكل؛ أما السلوك الحساس فيبقى في الكود. بهذه الحدود تبقى content/ آمنة ومفهومة لأي مساهم لاحقًا.

سؤال للخروج: إذا اختفى مجلد المحتوى ليوم واحد، ما أول شيء ستفتقده في موقعك؟