تثبيت وتكوين Jigsaw في بيئة ServBay

ما هو Jigsaw؟

Jigsaw هو مولد مواقع ثابتة يعتمد على Laravel، ومناسب لبناء الوثائق والمدونات والمواقع الثابتة البسيطة. يوفر نظام قوالب مرنًا وأدوات تطوير قوية، مما يجعل بناء وإدارة المواقع الثابتة أمرًا بسيطًا للغاية.

خطوات تثبيت Jigsaw

في هذه المقالة، سنشرح كيفية تثبيت وتكوين Jigsaw في بيئة ServBay.

الخطوة 1: إنشاء دليل المشروع

أولاً، قم بإنشاء دليل مشروع جديد في دليل www في ServBay:

cd /Applications/ServBay/www
mkdir servbay-jigsaw-app
cd servbay-jigsaw-app

الخطوة 2: إنشاء مشروع Jigsaw باستخدام Composer

يأتي ServBay مع Composer مدمج، لذا يمكننا استخدام Composer مباشرة لإنشاء مشروع Jigsaw:

composer create-project tightenco/jigsaw

الخطوة 3: تكوين خادم الويب

1. إضافة موقع جديد

   افتح ServBay، وانقر على علامة التبويب "المضيف"، وأضف موقعًا جديدًا:

   • الاسم: My Jigsaw Site
   • النطاق: servbay-jigsaw.local
   • نوع الموقع: PHP
   • إصدار PHP: اختر النسخة المناسبة من PHP
   • دليل الجذر للموقع: /Applications/ServBay/www/servbay-jigsaw-app/build_local

2. احفظ التكوين

   احفظ التكوين.

الخطوة 4: بناء موقع Jigsaw

1. تثبيت التبعيات

   قم بتشغيل الأوامر التالية في دليل المشروع لتثبيت تبعيات npm:

   npm install

2. بناء الموقع

   قم بتشغيل الأوامر التالية لبناء موقع Jigsaw:

   ./vendor/bin/jigsaw build

الخطوة 5: تشغيل خادم التطوير المحلي

1. الوصول إلى خادم التطوير

   افتح المتصفح، وقم بالوصول إلى https://servbay-jigsaw.local، سترى النسخة المحلية من موقع Jigsaw.

الخطوة 6: تخصيص موقع Jigsaw

1. تحرير المحتويات

   قم بتحرير ملفات Markdown وملفات القوالب Blade في دليل source لتخصيص محتوى وتصميم موقعك.

2. إضافة صفحات جديدة

   قم بإنشاء ملفات Markdown جديدة في دليل source لإضافة صفحات جديدة. على سبيل المثال، قم بإنشاء ملف about.md:

   ---
   title: "About Us"
   ---
   
   # About Us
   
   This is the about page.

3. تكوين قائمة التنقل

   قم بتحرير ملفات قوالب Blade في دليل source/_layouts لتخصيص روابط قائمة التنقل.

4. إعادة بناء الموقع

   في كل مرة تعدل فيها المحتوى أو القالب، قم بتشغيل الأوامر التالية لبناء موقع Jigsaw مجددًا:

   ./vendor/bin/jigsaw build

باستخدام Jigsaw لبناء الموقع

الآن، بعد أن قمت بتثبيت وتكوين Jigsaw بنجاح في بيئة ServBay، يمكنك البدء في استخدامه لبناء موقعك. إليك بعض العمليات الشائعة:

إنشاء مدونة

1. إضافة مقالات

   قم بإنشاء ملفات Markdown جديدة في دليل source/_posts لإضافة مقالات في المدونة. على سبيل المثال، قم بإنشاء ملف 2024-06-05-my-first-post.md:

   ---
   title: "My First Post"
   date: 2024-06-05
   ---
   
   # My First Post
   
   This is the content of my first post.

2. إعادة بناء الموقع

   قم بتشغيل الأوامر التالية لبناء موقع Jigsaw:

   ./vendor/bin/jigsaw build

تخصيص الأنماط والبرمجيات النصية

1. تحرير الأنماط

   قم بتحرير ملفات SCSS في دليل source/_assets/sass لتخصيص أنماط الموقع.

2. تحرير البرمجيات النصية

   قم بتعديل ملفات JavaScript في دليل source/_assets/js لتخصيص سلوك الموقع التفاعلي.

3. تجميع الموارد

   قم بتشغيل الأوامر التالية لتجميع ملفات SCSS و JavaScript:

   npm run dev

من خلال هذه الخطوات، تكون قد نجحت في تثبيت وتكوين Jigsaw في بيئة ServBay وبدأت في استخدامه لبناء موقعك. البساطة والمرونة تجعل Jigsaw خيارًا مثاليًا لبناء المواقع الثابتة.